{ "opencollection": "1.0.0", "info": { "name": "Asset Graph Account Management Global Data API", "version": "1.0.12" }, "items": [ { "info": { "name": "Global Data", "type": "folder" }, "items": [ { "info": { "name": "Censys Retrieve Multiple Certificates", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/certificate", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "certificate_ids", "value": "3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf", "type": "query", "description": "A list of SHA-256 certificate fingerprints." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.

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." }, { "info": { "name": "Censys Retrieve Multiple Certificates", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/asset/certificate", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint in the Censys dataset." }, { "info": { "name": "Censys Retrieve Multiple Certificates in PEM Format", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/certificate/raw", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "certificate_ids", "value": "3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf", "type": "query", "description": "A list of SHA-256 certificate fingerprints." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve the raw PEM-encoded format for multiple certificates. A certificate ID is its SHA-256 fingerprint in the Censys dataset.

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." }, { "info": { "name": "Censys Retrieve Multiple Certificates in PEM Format", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/asset/certificate/raw", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve the raw PEM-encoded format for multiple certificates. You can retrieve up to 1,000 certificates per call. A certificate ID is its SHA-256 fingerprint in the Censys dataset." }, { "info": { "name": "Censys Get a Certificate", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/certificate/:certificate_id", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "certificate_id", "value": "3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf", "type": "path", "description": "The SHA-256 certificate fingerprint." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about a single certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset." }, { "info": { "name": "Censys Get a Certificate in PEM Format", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/certificate/:certificate_id/raw", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "certificate_id", "value": "3daf2843a77b6f4e6af43cd9b6f6746053b8c928e056e8a724808db8905a94cf", "type": "path", "description": "The SHA-256 certificate fingerprint." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve the raw PEM-encoded format of a certificate. A certificate ID is its SHA-256 fingerprint in the Censys dataset." }, { "info": { "name": "Censys Retrieve Multiple Hosts", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/host", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "host_ids", "value": "8.8.8.8", "type": "query", "description": "A list of host IP addresses." }, { "name": "at_time", "value": "2025-01-01T00:00:00Z", "type": "query", "description": "RFC3339 Timestamp to view all requested hosts 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." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about multiple hosts. A host ID is its IP address.

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." }, { "info": { "name": "Censys Retrieve Multiple Hosts", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/asset/host", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about multiple hosts. You can retrieve up to 100 hosts per call. A host ID is its IP address." }, { "info": { "name": "Censys Get a Host", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/host/:host_id", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "host_id", "value": "8.8.8.8", "type": "path", "description": "The IP address of a host." }, { "name": "at_time", "value": "2025-01-01T00:00:00Z", "type": "query", "description": "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." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about a single host. A host ID is its IP address." }, { "info": { "name": "Censys Get Service History for a Host", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/host/:host_id/observations/services", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." }, { "name": "start_time", "value": "2024-01-01T00:00:00Z", "type": "query", "description": "Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time." }, { "name": "end_time", "value": "2024-01-31T23:59:59Z", "type": "query", "description": "End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future." }, { "name": "page_size", "value": "50", "type": "query", "description": "Number of results per page (max 100)" }, { "name": "page_token", "value": "", "type": "query", "description": "Pagination token from previous response" }, { "name": "port", "value": "443", "type": "query", "description": "Filter by port number" }, { "name": "protocol", "value": "HTTP", "type": "query", "description": "Filter by application protocol" }, { "name": "transport_protocol", "value": "tcp", "type": "query", "description": "Filter by transport protocol" }, { "name": "host_id", "value": "8.8.8.8", "type": "path", "description": "The IP address of a host." }, { "name": "order_by", "value": "", "type": "query", "description": "Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC'])." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve historical service observations for a host. This endpoint returns time ranges during which services were detected on the host.

You can define a specific time frame of interest. If you do not specify a time frame, this endpoint will search the historical dataset that is available to your account.

You can filter by port number, protocol, and transport protocol." }, { "info": { "name": "Censys Get Host Event History", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/host/:host_id/timeline", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "host_id", "value": "8.8.8.8", "type": "path", "description": "The IP address of a host." }, { "name": "start_time", "value": "2025-01-02T00:00:00Z", "type": "query", "description": "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." }, { "name": "end_time", "value": "2025-01-01T00:00:00Z", "type": "query", "description": "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." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve event history for a host. A host ID is its IP address.

Note that when a service protocol changes after a new scan (for example, from `UNKNOWN` to `NETBIOS`), this information will be reflected in the `scan` object." }, { "info": { "name": "Censys Retrieve Multiple Web Properties", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/webproperty", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "webproperty_ids", "value": "platform.censys.io:80", "type": "query", "description": "A list of web property identifiers." }, { "name": "at_time", "value": "2025-01-01T00:00:00Z", "type": "query", "description": "RFC3339 Timestamp to view all requested webproperties 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" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "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`.

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." }, { "info": { "name": "Censys Retrieve Multiple Web Properties", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/asset/webproperty", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve information about multiple web properties. You can retrieve up to 100 web properties per call. Web properties are identified using a combination of a hostname and port joined with a colon, such as `platform.censys.io:80`." }, { "info": { "name": "Censys Get a Web Property", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/asset/webproperty/:webproperty_id", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." }, { "name": "webproperty_id", "value": "platform.censys.io:80", "type": "path", "description": "A web property identifier." }, { "name": "at_time", "value": "2025-01-01T00:00:00Z", "type": "query", "description": "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" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "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`." }, { "info": { "name": "Censys Get Latest DNS Names That Resolved to an IP", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/dns/resolutions/ip/:ip/bounds", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." }, { "name": "start_time", "value": "2024-01-01T00:00:00Z", "type": "query", "description": "Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time." }, { "name": "end_time", "value": "2024-01-31T23:59:59Z", "type": "query", "description": "End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future." }, { "name": "page_size", "value": "50", "type": "query", "description": "Number of results per page (max 100)" }, { "name": "page_token", "value": "", "type": "query", "description": "Pagination token from previous response" }, { "name": "record_types", "value": "A", "type": "query", "description": "Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted." }, { "name": "ip", "value": "8.8.8.8", "type": "path", "description": "The IP address of a DNS record." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve the latest domain names that resolved to the IP you provide (A and AAAA). You can narrow results with `record_types` (A or AAAA).

[Learn more about Censys Active DNS Resolution](https://docs.censys.com/docs/platform-active-dns).

This endpoint is in beta and is only available to Censys Enterprise users." }, { "info": { "name": "Censys Get DNS Names That Resolved to an IP Within a Time Window", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/dns/resolutions/ip/:ip/ranges", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." }, { "name": "start_time", "value": "2024-01-01T00:00:00Z", "type": "query", "description": "Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time." }, { "name": "end_time", "value": "2024-01-31T23:59:59Z", "type": "query", "description": "End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future." }, { "name": "page_size", "value": "50", "type": "query", "description": "Number of results per page (max 100)" }, { "name": "page_token", "value": "", "type": "query", "description": "Pagination token from previous response" }, { "name": "record_types", "value": "A", "type": "query", "description": "Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted." }, { "name": "domain", "value": "platform.censys.io", "type": "query", "description": "Filter to a specific domain name resolving to this IP." }, { "name": "ip", "value": "8.8.8.8", "type": "path", "description": "The IP address of a DNS record." } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve domain names that resolved to the IP you provide (A and AAAA) within the requested time window.

[Learn more about Censys Active DNS Resolution](https://docs.censys.com/docs/platform-active-dns).

This endpoint is in beta and is only available to Censys Enterprise users." }, { "info": { "name": "Censys Get Latest DNS Resolution Records for a Name", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/dns/resolutions/:name/bounds", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." }, { "name": "start_time", "value": "2024-01-01T00:00:00Z", "type": "query", "description": "Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time." }, { "name": "end_time", "value": "2024-01-31T23:59:59Z", "type": "query", "description": "End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future." }, { "name": "page_size", "value": "50", "type": "query", "description": "Number of results per page (max 100)" }, { "name": "page_token", "value": "", "type": "query", "description": "Pagination token from previous response" }, { "name": "record_types", "value": "MX", "type": "query", "description": "Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted." }, { "name": "name", "value": "platform.censys.io", "type": "path", "description": "The domain name" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve the latest DNS resolution records for a name. This endpoint returns the latest observed A, AAAA, MX, NS, SOA, and TXT records for the name you provide. You can filter by one or more record types using `record_types`.

[Learn more about Censys Active DNS Resolution](https://docs.censys.com/docs/platform-active-dns).

This endpoint is in beta and is only available to Censys Enterprise users." }, { "info": { "name": "Censys Get Historical DNS Resolution Ranges for a Name", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/dns/resolutions/:name/ranges", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." }, { "name": "start_time", "value": "2024-01-01T00:00:00Z", "type": "query", "description": "Start of date range (RFC3339 format, e.g., 2024-01-01T00:00:00Z). If not specified, defaults to the maximum query window back from the end time." }, { "name": "end_time", "value": "2024-01-31T23:59:59Z", "type": "query", "description": "End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future." }, { "name": "page_size", "value": "50", "type": "query", "description": "Number of results per page (max 100)" }, { "name": "page_token", "value": "", "type": "query", "description": "Pagination token from previous response" }, { "name": "record_types", "value": "MX", "type": "query", "description": "Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted." }, { "name": "name", "value": "platform.censys.io", "type": "path", "description": "The domain name" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Retrieve historical DNS resolution observations for a name. Each item is one window during which a record value was observed by Censys.

[Learn more about Censys Active DNS Resolution](https://docs.censys.com/docs/platform-active-dns).

This endpoint is in beta and is only available to Censys Enterprise users." }, { "info": { "name": "Censys Live Rescan: Initiate a New Rescan", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/scans/rescan", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "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.

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#" }, { "info": { "name": "Censys Get Scan Status", "type": "http" }, "http": { "method": "GET", "url": "https://graph.data.censys.io/v3/global/scans/:scan_id", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." }, { "name": "scan_id", "value": "", "type": "path", "description": "The unique identifier of the tracked scan" } ], "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "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#/).

If the scan was successful, perform a lookup on the target asset to retrieve detailed scan information.

This endpoint is available to all Enterprise customers. This endpoint does not cost any credits to execute." }, { "info": { "name": "Censys Aggregate Results for a Search Query", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/search/aggregate", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "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." }, { "info": { "name": "Censys Convert Legacy Search Queries to Platform Queries", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/search/convert", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "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-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "Convert Censys Search Language queries used in Legacy Search into Censys Query Language (CenQL) queries for use in the Platform.

Reference the [documentation on CenQL](https://docs.censys.com/docs/censys-query-language) for more information about query syntax." }, { "info": { "name": "Censys Run a Search Query", "type": "http" }, "http": { "method": "POST", "url": "https://graph.data.censys.io/v3/global/search/query", "headers": [ { "name": "X-Organization-ID", "value": "11111111-2222-3333-4444-555555555555" } ], "params": [ { "name": "organization_id", "value": "11111111-2222-3333-4444-555555555555", "type": "query", "description": "The ID of a Censys organization to associate the request with. If omitted, the request will be processed using the authenticated user's free wallet where applicable. See the [Getting Started docs](https://docs.censys.com/reference/get-started#step-3-find-and-use-your-organization-id-optional) for more information." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "docs": "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. Host services that match your search criteria will be returned in a `matched_services` object." } ] } ], "bundled": true }