censys 1.0.36

data/lib/censys/api/global_data_api.rb

@@ -0,0 +1,1416 @@
+=begin
+#Censys Platform API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 1.0.36
+Contact: support@censys.com
+Generated by: https://openapi-generator.tech
+Generator version: 7.16.0-SNAPSHOT
+
+=end
+
+require 'cgi'
+
+module CensysApi
+  class GlobalDataApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get a certificate
+    # Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_id [String] The SHA-256 certificate fingerprint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeCertificateAsset]
+    def v3_globaldata_asset_certificate(organization_id, certificate_id, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_certificate_with_http_info(organization_id, certificate_id, opts)
+      data
+    end
+
+    # Get a certificate
+    # Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_id [String] The SHA-256 certificate fingerprint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeCertificateAsset, Integer, Hash)>] ResponseEnvelopeCertificateAsset data, response status code and response headers
+    def v3_globaldata_asset_certificate_with_http_info(organization_id, certificate_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_certificate ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_certificate"
+      end
+      # verify the required parameter 'certificate_id' is set
+      if @api_client.config.client_side_validation && certificate_id.nil?
+        fail ArgumentError, "Missing the required parameter 'certificate_id' when calling GlobalDataApi.v3_globaldata_asset_certificate"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/certificate/{certificate_id}'.sub('{' + 'certificate_id' + '}', CGI.escape(certificate_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.certificate.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeCertificateAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_certificate",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_certificate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple certificates
+    # Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-certificate-list-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_ids [Array<String>] A list of SHA-256 certificate fingerprints.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListCertificateAsset]
+    def v3_globaldata_asset_certificate_list(organization_id, certificate_ids, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_certificate_list_with_http_info(organization_id, certificate_ids, opts)
+      data
+    end
+
+    # Retrieve multiple certificates
+    # Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.&lt;br&gt;&lt;br&gt;The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-certificate-list-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_ids [Array<String>] A list of SHA-256 certificate fingerprints.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListCertificateAsset, Integer, Hash)>] ResponseEnvelopeListCertificateAsset data, response status code and response headers
+    def v3_globaldata_asset_certificate_list_with_http_info(organization_id, certificate_ids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_certificate_list ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_certificate_list"
+      end
+      if @api_client.config.client_side_validation && certificate_ids.length > 1000
+        fail ArgumentError, 'invalid value for "certificate_ids" when calling GlobalDataApi.v3_globaldata_asset_certificate_list, number of items must be less than or equal to 1000.'
+      end
+
+      if @api_client.config.client_side_validation && certificate_ids.length < 1
+        fail ArgumentError, 'invalid value for "certificate_ids" when calling GlobalDataApi.v3_globaldata_asset_certificate_list, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v3/global/asset/certificate'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'certificate_ids'] = @api_client.build_collection_param(certificate_ids, :csv)
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.certificate.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListCertificateAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_certificate_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_certificate_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple certificates
+    # Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_certificate_list_input_body [AssetCertificateListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListCertificateAsset]
+    def v3_globaldata_asset_certificate_list_post(organization_id, asset_certificate_list_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_certificate_list_post_with_http_info(organization_id, asset_certificate_list_input_body, opts)
+      data
+    end
+
+    # Retrieve multiple certificates
+    # Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_certificate_list_input_body [AssetCertificateListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListCertificateAsset, Integer, Hash)>] ResponseEnvelopeListCertificateAsset data, response status code and response headers
+    def v3_globaldata_asset_certificate_list_post_with_http_info(organization_id, asset_certificate_list_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_certificate_list_post ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_certificate_list_post"
+      end
+      # verify the required parameter 'asset_certificate_list_input_body' is set
+      if @api_client.config.client_side_validation && asset_certificate_list_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_certificate_list_input_body' when calling GlobalDataApi.v3_globaldata_asset_certificate_list_post"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/certificate'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.certificate.v1+json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(asset_certificate_list_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListCertificateAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_certificate_list_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_certificate_list_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple certificates in PEM format
+    # Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-certificate-list-raw-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_ids [Array<String>] A list of SHA-256 certificate fingerprints.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListRawCertificateResponse]
+    def v3_globaldata_asset_certificate_list_raw(organization_id, certificate_ids, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_certificate_list_raw_with_http_info(organization_id, certificate_ids, opts)
+      data
+    end
+
+    # Retrieve multiple certificates in PEM format
+    # Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.&lt;br&gt;&lt;br&gt;The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-certificate-list-raw-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_ids [Array<String>] A list of SHA-256 certificate fingerprints.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListRawCertificateResponse, Integer, Hash)>] ResponseEnvelopeListRawCertificateResponse data, response status code and response headers
+    def v3_globaldata_asset_certificate_list_raw_with_http_info(organization_id, certificate_ids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_certificate_list_raw ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_certificate_list_raw"
+      end
+      if @api_client.config.client_side_validation && certificate_ids.length > 1000
+        fail ArgumentError, 'invalid value for "certificate_ids" when calling GlobalDataApi.v3_globaldata_asset_certificate_list_raw, number of items must be less than or equal to 1000.'
+      end
+
+      if @api_client.config.client_side_validation && certificate_ids.length < 1
+        fail ArgumentError, 'invalid value for "certificate_ids" when calling GlobalDataApi.v3_globaldata_asset_certificate_list_raw, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v3/global/asset/certificate/raw'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'certificate_ids'] = @api_client.build_collection_param(certificate_ids, :csv)
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListRawCertificateResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_certificate_list_raw",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_certificate_list_raw\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple certificates in PEM format
+    # Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_certificate_list_input_body [AssetCertificateListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListRawCertificateResponse]
+    def v3_globaldata_asset_certificate_list_raw_post(organization_id, asset_certificate_list_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_certificate_list_raw_post_with_http_info(organization_id, asset_certificate_list_input_body, opts)
+      data
+    end
+
+    # Retrieve multiple certificates in PEM format
+    # Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_certificate_list_input_body [AssetCertificateListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListRawCertificateResponse, Integer, Hash)>] ResponseEnvelopeListRawCertificateResponse data, response status code and response headers
+    def v3_globaldata_asset_certificate_list_raw_post_with_http_info(organization_id, asset_certificate_list_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_certificate_list_raw_post ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_certificate_list_raw_post"
+      end
+      # verify the required parameter 'asset_certificate_list_input_body' is set
+      if @api_client.config.client_side_validation && asset_certificate_list_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_certificate_list_input_body' when calling GlobalDataApi.v3_globaldata_asset_certificate_list_raw_post"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/certificate/raw'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(asset_certificate_list_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListRawCertificateResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_certificate_list_raw_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_certificate_list_raw_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a certificate in PEM format
+    # Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_id [String] The SHA-256 certificate fingerprint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [File]
+    def v3_globaldata_asset_certificate_raw(organization_id, certificate_id, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_certificate_raw_with_http_info(organization_id, certificate_id, opts)
+      data
+    end
+
+    # Get a certificate in PEM format
+    # Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param certificate_id [String] The SHA-256 certificate fingerprint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
+    def v3_globaldata_asset_certificate_raw_with_http_info(organization_id, certificate_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_certificate_raw ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_certificate_raw"
+      end
+      # verify the required parameter 'certificate_id' is set
+      if @api_client.config.client_side_validation && certificate_id.nil?
+        fail ArgumentError, "Missing the required parameter 'certificate_id' when calling GlobalDataApi.v3_globaldata_asset_certificate_raw"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/certificate/{certificate_id}/raw'.sub('{' + 'certificate_id' + '}', CGI.escape(certificate_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/x-pem-file', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'File'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_certificate_raw",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_certificate_raw\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a host
+    # Retrieve information about a single host. A host ID is its IP address.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param host_id [String] The IP address of a host.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @option opts [Time] :at_time RFC3339 Timestamp to view a host at a specific point in time. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
+    # @return [ResponseEnvelopeHostAsset]
+    def v3_globaldata_asset_host(organization_id, host_id, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_host_with_http_info(organization_id, host_id, opts)
+      data
+    end
+
+    # Get a host
+    # Retrieve information about a single host. A host ID is its IP address.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param host_id [String] The IP address of a host.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @option opts [Time] :at_time RFC3339 Timestamp to view a host at a specific point in time. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
+    # @return [Array<(ResponseEnvelopeHostAsset, Integer, Hash)>] ResponseEnvelopeHostAsset data, response status code and response headers
+    def v3_globaldata_asset_host_with_http_info(organization_id, host_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_host ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_host"
+      end
+      # verify the required parameter 'host_id' is set
+      if @api_client.config.client_side_validation && host_id.nil?
+        fail ArgumentError, "Missing the required parameter 'host_id' when calling GlobalDataApi.v3_globaldata_asset_host"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/host/{host_id}'.sub('{' + 'host_id' + '}', CGI.escape(host_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'at_time'] = opts[:'at_time'] if !opts[:'at_time'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.host.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeHostAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_host",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_host\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple hosts
+    # Retrieve information about multiple hosts. A host ID is its IP address.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-host-list-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param host_ids [Array<String>] A list of host IP addresses.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListHostAsset]
+    def v3_globaldata_asset_host_list(organization_id, host_ids, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_host_list_with_http_info(organization_id, host_ids, opts)
+      data
+    end
+
+    # Retrieve multiple hosts
+    # Retrieve information about multiple hosts. A host ID is its IP address.&lt;br&gt;&lt;br&gt;The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-host-list-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param host_ids [Array<String>] A list of host IP addresses.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListHostAsset, Integer, Hash)>] ResponseEnvelopeListHostAsset data, response status code and response headers
+    def v3_globaldata_asset_host_list_with_http_info(organization_id, host_ids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_host_list ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_host_list"
+      end
+      if @api_client.config.client_side_validation && host_ids.length > 100
+        fail ArgumentError, 'invalid value for "host_ids" when calling GlobalDataApi.v3_globaldata_asset_host_list, number of items must be less than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && host_ids.length < 1
+        fail ArgumentError, 'invalid value for "host_ids" when calling GlobalDataApi.v3_globaldata_asset_host_list, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v3/global/asset/host'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'host_ids'] = @api_client.build_collection_param(host_ids, :csv)
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.host.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListHostAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_host_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_host_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple hosts
+    # Retrieve information about multiple hosts. A host ID is its IP address.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_host_list_input_body [AssetHostListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListHostAsset]
+    def v3_globaldata_asset_host_list_post(organization_id, asset_host_list_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_host_list_post_with_http_info(organization_id, asset_host_list_input_body, opts)
+      data
+    end
+
+    # Retrieve multiple hosts
+    # Retrieve information about multiple hosts. A host ID is its IP address.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_host_list_input_body [AssetHostListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListHostAsset, Integer, Hash)>] ResponseEnvelopeListHostAsset data, response status code and response headers
+    def v3_globaldata_asset_host_list_post_with_http_info(organization_id, asset_host_list_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_host_list_post ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_host_list_post"
+      end
+      # verify the required parameter 'asset_host_list_input_body' is set
+      if @api_client.config.client_side_validation && asset_host_list_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_host_list_input_body' when calling GlobalDataApi.v3_globaldata_asset_host_list_post"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/host'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.host.v1+json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(asset_host_list_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListHostAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_host_list_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_host_list_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get host event history
+    # Retrieve event history for a host. A host ID is its IP address.<br><br>Note that when a service protocol changes after a new scan (for example, from `UNKNOWN` to `NETBIOS`), this information will only be reflected in the `scan` object. It will not be shown in the `service_scanned diff` object.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param host_id [String] The IP address of a host.
+    # @param start_time [Time] Start time of the host timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
+    # @param end_time [Time] End time of the host timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeHostTimeline]
+    def v3_globaldata_asset_host_timeline(organization_id, host_id, start_time, end_time, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_host_timeline_with_http_info(organization_id, host_id, start_time, end_time, opts)
+      data
+    end
+
+    # Get host event history
+    # Retrieve event history for a host. A host ID is its IP address.&lt;br&gt;&lt;br&gt;Note that when a service protocol changes after a new scan (for example, from &#x60;UNKNOWN&#x60; to &#x60;NETBIOS&#x60;), this information will only be reflected in the &#x60;scan&#x60; object. It will not be shown in the &#x60;service_scanned diff&#x60; object.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param host_id [String] The IP address of a host.
+    # @param start_time [Time] Start time of the host timeline. Equivalent to the To field in the event history UI. This must be the timestamp closest to the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 2 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
+    # @param end_time [Time] End time of the host timeline. Equivalent to the From field in the event history UI. This must be the timestamp furthest from the current time. For example, if you want events from January 1, 2025 to the start of January 2, 2025, input the January 1 timestamp here. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeHostTimeline, Integer, Hash)>] ResponseEnvelopeHostTimeline data, response status code and response headers
+    def v3_globaldata_asset_host_timeline_with_http_info(organization_id, host_id, start_time, end_time, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_host_timeline ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_host_timeline"
+      end
+      # verify the required parameter 'host_id' is set
+      if @api_client.config.client_side_validation && host_id.nil?
+        fail ArgumentError, "Missing the required parameter 'host_id' when calling GlobalDataApi.v3_globaldata_asset_host_timeline"
+      end
+      # verify the required parameter 'start_time' is set
+      if @api_client.config.client_side_validation && start_time.nil?
+        fail ArgumentError, "Missing the required parameter 'start_time' when calling GlobalDataApi.v3_globaldata_asset_host_timeline"
+      end
+      # verify the required parameter 'end_time' is set
+      if @api_client.config.client_side_validation && end_time.nil?
+        fail ArgumentError, "Missing the required parameter 'end_time' when calling GlobalDataApi.v3_globaldata_asset_host_timeline"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/host/{host_id}/timeline'.sub('{' + 'host_id' + '}', CGI.escape(host_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'start_time'] = start_time
+      query_params[:'end_time'] = end_time
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.host_timeline_event.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeHostTimeline'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_host_timeline",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_host_timeline\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get a web property
+    # Retrieve information about a single web property. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param webproperty_id [String] A web property identifier.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @option opts [Time] :at_time RFC3339 Timestamp to view a webproperty at a specific point in time. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time
+    # @return [ResponseEnvelopeWebpropertyAsset]
+    def v3_globaldata_asset_webproperty(organization_id, webproperty_id, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_webproperty_with_http_info(organization_id, webproperty_id, opts)
+      data
+    end
+
+    # Get a web property
+    # Retrieve information about a single web property. Web properties are identified using a combination of a hostname and port joined with a colon, such as &#x60;platform.censys.io:80&#x60;.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param webproperty_id [String] A web property identifier.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @option opts [Time] :at_time RFC3339 Timestamp to view a webproperty at a specific point in time. Must be a valid RFC3339 string. Ensure that you suffix the date with T00:00:00Z or a specific time
+    # @return [Array<(ResponseEnvelopeWebpropertyAsset, Integer, Hash)>] ResponseEnvelopeWebpropertyAsset data, response status code and response headers
+    def v3_globaldata_asset_webproperty_with_http_info(organization_id, webproperty_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_webproperty ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_webproperty"
+      end
+      # verify the required parameter 'webproperty_id' is set
+      if @api_client.config.client_side_validation && webproperty_id.nil?
+        fail ArgumentError, "Missing the required parameter 'webproperty_id' when calling GlobalDataApi.v3_globaldata_asset_webproperty"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/webproperty/{webproperty_id}'.sub('{' + 'webproperty_id' + '}', CGI.escape(webproperty_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'at_time'] = opts[:'at_time'] if !opts[:'at_time'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.webproperty.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeWebpropertyAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_webproperty",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_webproperty\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple web properties
+    # Retrieve information about multiple web properties. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.<br><br>The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-webproperty-list-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param webproperty_ids [Array<String>] A list of web property identifiers.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListWebpropertyAsset]
+    def v3_globaldata_asset_webproperty_list(organization_id, webproperty_ids, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_webproperty_list_with_http_info(organization_id, webproperty_ids, opts)
+      data
+    end
+
+    # Retrieve multiple web properties
+    # Retrieve information about multiple web properties. Web properties are identified using a combination of a hostname and port joined with a colon, such as &#x60;platform.censys.io:80&#x60;.&lt;br&gt;&lt;br&gt;The GET method of this endpoint is deprecated, but will continue to be supported for backwards compatibility. Please use the [POST variant](https://docs.censys.com/reference/v3-globaldata-asset-webproperty-list-post#/) of this endpoint instead.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param webproperty_ids [Array<String>] A list of web property identifiers.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListWebpropertyAsset, Integer, Hash)>] ResponseEnvelopeListWebpropertyAsset data, response status code and response headers
+    def v3_globaldata_asset_webproperty_list_with_http_info(organization_id, webproperty_ids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_webproperty_list ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_webproperty_list"
+      end
+      if @api_client.config.client_side_validation && webproperty_ids.length > 100
+        fail ArgumentError, 'invalid value for "webproperty_ids" when calling GlobalDataApi.v3_globaldata_asset_webproperty_list, number of items must be less than or equal to 100.'
+      end
+
+      if @api_client.config.client_side_validation && webproperty_ids.length < 1
+        fail ArgumentError, 'invalid value for "webproperty_ids" when calling GlobalDataApi.v3_globaldata_asset_webproperty_list, number of items must be greater than or equal to 1.'
+      end
+
+      # resource path
+      local_var_path = '/v3/global/asset/webproperty'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+      query_params[:'webproperty_ids'] = @api_client.build_collection_param(webproperty_ids, :csv)
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.webproperty.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListWebpropertyAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_webproperty_list",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_webproperty_list\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Retrieve multiple web properties
+    # Retrieve information about multiple web properties. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_webproperty_list_input_body [AssetWebpropertyListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListWebpropertyAsset]
+    def v3_globaldata_asset_webproperty_list_post(organization_id, asset_webproperty_list_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_asset_webproperty_list_post_with_http_info(organization_id, asset_webproperty_list_input_body, opts)
+      data
+    end
+
+    # Retrieve multiple web properties
+    # Retrieve information about multiple web properties. Web properties are identified using a combination of a hostname and port joined with a colon, such as &#x60;platform.censys.io:80&#x60;.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param asset_webproperty_list_input_body [AssetWebpropertyListInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListWebpropertyAsset, Integer, Hash)>] ResponseEnvelopeListWebpropertyAsset data, response status code and response headers
+    def v3_globaldata_asset_webproperty_list_post_with_http_info(organization_id, asset_webproperty_list_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_asset_webproperty_list_post ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_asset_webproperty_list_post"
+      end
+      # verify the required parameter 'asset_webproperty_list_input_body' is set
+      if @api_client.config.client_side_validation && asset_webproperty_list_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'asset_webproperty_list_input_body' when calling GlobalDataApi.v3_globaldata_asset_webproperty_list_post"
+      end
+      # resource path
+      local_var_path = '/v3/global/asset/webproperty'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.webproperty.v1+json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(asset_webproperty_list_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListWebpropertyAsset'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_asset_webproperty_list_post",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_asset_webproperty_list_post\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get scan status
+    # Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).<br><br>If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param scan_id [String] The unique identifier of the tracked scan
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeTrackedScan]
+    def v3_globaldata_scans_get(organization_id, scan_id, opts = {})
+      data, _status_code, _headers = v3_globaldata_scans_get_with_http_info(organization_id, scan_id, opts)
+      data
+    end
+
+    # Get scan status
+    # Retrieve the current status of a scan by its ID. This endpoint works for both [Live Discovery scans](https://docs.censys.com/reference/v3-threathunting-scans-discovery#/) and [Live Rescans](https://docs.censys.com/reference/v3-globaldata-scans-rescan#/).&lt;br&gt;&lt;br&gt;If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.&lt;br&gt;&lt;br&gt;This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param scan_id [String] The unique identifier of the tracked scan
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeTrackedScan, Integer, Hash)>] ResponseEnvelopeTrackedScan data, response status code and response headers
+    def v3_globaldata_scans_get_with_http_info(organization_id, scan_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_scans_get ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_scans_get"
+      end
+      # verify the required parameter 'scan_id' is set
+      if @api_client.config.client_side_validation && scan_id.nil?
+        fail ArgumentError, "Missing the required parameter 'scan_id' when calling GlobalDataApi.v3_globaldata_scans_get"
+      end
+      # resource path
+      local_var_path = '/v3/global/scans/{scan_id}'.sub('{' + 'scan_id' + '}', CGI.escape(scan_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/vnd.censys.api.v3.trackedscan.v1+json', 'application/problem+json']) unless header_params['Accept']
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeTrackedScan'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_scans_get",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_scans_get\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Live Rescan: Initiate a new rescan
+    # Initiate a rescan for a known host service at a specific IP and port (`ip:port`) or hostname and port (`hostname:port`). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.<br><br>The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan's status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.<br><br>This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param scans_rescan_input_body [ScansRescanInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeTrackedScan]
+    def v3_globaldata_scans_rescan(organization_id, scans_rescan_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_scans_rescan_with_http_info(organization_id, scans_rescan_input_body, opts)
+      data
+    end
+
+    # Live Rescan: Initiate a new rescan
+    # Initiate a rescan for a known host service at a specific IP and port (&#x60;ip:port&#x60;) or hostname and port (&#x60;hostname:port&#x60;). This is equivalent to the [Live Rescan](https://docs.censys.com/docs/platform-live-rescan#/) feature available in the UI, but you can also target web properties in addition to hosts.&lt;br&gt;&lt;br&gt;The scan may take several minutes to complete. The response will contain a scan ID that you can use to [monitor the scan&#39;s status](https://docs.censys.com/reference/v3-globaldata-scans-get#/). After the scan completes, perform a lookup on the target asset to retrieve detailed scan information.&lt;br&gt;&lt;br&gt;This endpoint is available to all Enterprise customers. It costs 10 credits to execute.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param scans_rescan_input_body [ScansRescanInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeTrackedScan, Integer, Hash)>] ResponseEnvelopeTrackedScan data, response status code and response headers
+    def v3_globaldata_scans_rescan_with_http_info(organization_id, scans_rescan_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_scans_rescan ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_scans_rescan"
+      end
+      # verify the required parameter 'scans_rescan_input_body' is set
+      if @api_client.config.client_side_validation && scans_rescan_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'scans_rescan_input_body' when calling GlobalDataApi.v3_globaldata_scans_rescan"
+      end
+      # resource path
+      local_var_path = '/v3/global/scans/rescan'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(scans_rescan_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeTrackedScan'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_scans_rescan",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_scans_rescan\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Aggregate results for a search query
+    # Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param search_aggregate_input_body [SearchAggregateInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeSearchAggregateResponse]
+    def v3_globaldata_search_aggregate(organization_id, search_aggregate_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_search_aggregate_with_http_info(organization_id, search_aggregate_input_body, opts)
+      data
+    end
+
+    # Aggregate results for a search query
+    # Aggregate results for a Platform search query. This functionality is equivalent to the [Report Builder](https://docs.censys.com/docs/platform-report-builder#/) in the Platform web UI.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param search_aggregate_input_body [SearchAggregateInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeSearchAggregateResponse, Integer, Hash)>] ResponseEnvelopeSearchAggregateResponse data, response status code and response headers
+    def v3_globaldata_search_aggregate_with_http_info(organization_id, search_aggregate_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_search_aggregate ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_search_aggregate"
+      end
+      # verify the required parameter 'search_aggregate_input_body' is set
+      if @api_client.config.client_side_validation && search_aggregate_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'search_aggregate_input_body' when calling GlobalDataApi.v3_globaldata_search_aggregate"
+      end
+      # resource path
+      local_var_path = '/v3/global/search/aggregate'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(search_aggregate_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeSearchAggregateResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_search_aggregate",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_search_aggregate\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Convert Legacy Search queries to Platform queries
+    # Convert Censys Search Language queries used in Legacy Search into Censys Query Language (CenQL) queries for use in the Platform.<br><br>Reference the [documentation on CenQL](https://docs.censys.com/docs/censys-query-language) for more information about query syntax.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param search_convert_query_input_body [SearchConvertQueryInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeListSearchConvertQueryResponse]
+    def v3_globaldata_search_convert(organization_id, search_convert_query_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_search_convert_with_http_info(organization_id, search_convert_query_input_body, opts)
+      data
+    end
+
+    # Convert Legacy Search queries to Platform queries
+    # Convert Censys Search Language queries used in Legacy Search into Censys Query Language (CenQL) queries for use in the Platform.&lt;br&gt;&lt;br&gt;Reference the [documentation on CenQL](https://docs.censys.com/docs/censys-query-language) for more information about query syntax.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param search_convert_query_input_body [SearchConvertQueryInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeListSearchConvertQueryResponse, Integer, Hash)>] ResponseEnvelopeListSearchConvertQueryResponse data, response status code and response headers
+    def v3_globaldata_search_convert_with_http_info(organization_id, search_convert_query_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_search_convert ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_search_convert"
+      end
+      # verify the required parameter 'search_convert_query_input_body' is set
+      if @api_client.config.client_side_validation && search_convert_query_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'search_convert_query_input_body' when calling GlobalDataApi.v3_globaldata_search_convert"
+      end
+      # resource path
+      local_var_path = '/v3/global/search/convert'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(search_convert_query_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeListSearchConvertQueryResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_search_convert",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_search_convert\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Run a search query
+    # Run a search query across Censys data. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param search_query_input_body [SearchQueryInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [ResponseEnvelopeSearchQueryResponse]
+    def v3_globaldata_search_query(organization_id, search_query_input_body, opts = {})
+      data, _status_code, _headers = v3_globaldata_search_query_with_http_info(organization_id, search_query_input_body, opts)
+      data
+    end
+
+    # Run a search query
+    # Run a search query across Censys data. Reference the [documentation on Censys Query Language](https://docs.censys.com/docs/censys-query-language#/) for information about query syntax.
+    # @param organization_id [String] The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information.
+    # @param search_query_input_body [SearchQueryInputBody] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :x_organization_id The ID of a Censys organization to associate the request with. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-set-your-organization-id) for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field in the query parameter instead.
+    # @return [Array<(ResponseEnvelopeSearchQueryResponse, Integer, Hash)>] ResponseEnvelopeSearchQueryResponse data, response status code and response headers
+    def v3_globaldata_search_query_with_http_info(organization_id, search_query_input_body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: GlobalDataApi.v3_globaldata_search_query ...'
+      end
+      # verify the required parameter 'organization_id' is set
+      if @api_client.config.client_side_validation && organization_id.nil?
+        fail ArgumentError, "Missing the required parameter 'organization_id' when calling GlobalDataApi.v3_globaldata_search_query"
+      end
+      # verify the required parameter 'search_query_input_body' is set
+      if @api_client.config.client_side_validation && search_query_input_body.nil?
+        fail ArgumentError, "Missing the required parameter 'search_query_input_body' when calling GlobalDataApi.v3_globaldata_search_query"
+      end
+      # resource path
+      local_var_path = '/v3/global/search/query'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'organization_id'] = organization_id
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/problem+json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'X-Organization-ID'] = opts[:'x_organization_id'] if !opts[:'x_organization_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(search_query_input_body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResponseEnvelopeSearchQueryResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PersonalAccessToken']
+
+      new_options = opts.merge(
+        :operation => :"GlobalDataApi.v3_globaldata_search_query",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: GlobalDataApi#v3_globaldata_search_query\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end