naftiko: 1.0.0-alpha2 info: label: Censys Platform — Global Data description: 'Censys Platform — Global Data. 23 operation(s). Lead operation: Censys Retrieve Multiple Certificates. Self-contained Naftiko capability covering one Censys business surface.' tags: - Censys - Platform - Global Data created: '2026-05-29' modified: '2026-05-29' binds: - namespace: env keys: CENSYS_PERSONAL_ACCESS_TOKEN: CENSYS_PERSONAL_ACCESS_TOKEN capability: consumes: - type: http namespace: platform-global-data baseUri: https://api.platform.censys.io description: Censys Platform — Global Data business capability. Self-contained, no shared references. authentication: type: bearer token: '{{env.CENSYS_PERSONAL_ACCESS_TOKEN}}' resources: - name: v3-global-asset-certificate path: /v3/global/asset/certificate operations: - name: v3-globaldata-asset-certificate-list method: GET description: Censys Retrieve Multiple Certificates inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: certificate_ids in: query type: - array - "null" required: true description: A list of SHA-256 certificate fingerprints. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-globaldata-asset-certificate-list-post method: POST description: Censys Retrieve Multiple Certificates inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-certificate-raw path: /v3/global/asset/certificate/raw operations: - name: v3-globaldata-asset-certificate-list-raw method: GET description: Censys Retrieve Multiple Certificates in PEM Format inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: certificate_ids in: query type: - array - "null" required: true description: A list of SHA-256 certificate fingerprints. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-globaldata-asset-certificate-list-raw-post method: POST description: Censys Retrieve Multiple Certificates in PEM Format inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-certificate-certificate-id path: /v3/global/asset/certificate/{certificate_id} operations: - name: v3-globaldata-asset-certificate method: GET description: Censys Get a Certificate inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: certificate_id in: path type: string required: true description: The SHA-256 certificate fingerprint. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-certificate-certificate-id-raw path: /v3/global/asset/certificate/{certificate_id}/raw operations: - name: v3-globaldata-asset-certificate-raw method: GET description: Censys Get a Certificate in PEM Format inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: certificate_id in: path type: string required: true description: The SHA-256 certificate fingerprint. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-host path: /v3/global/asset/host operations: - name: v3-globaldata-asset-host-list method: GET description: Censys Retrieve Multiple Hosts inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: host_ids in: query type: - array - "null" required: true description: A list of host IP addresses. - name: at_time in: query type: string required: false 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. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-globaldata-asset-host-list-post method: POST description: Censys Retrieve Multiple Hosts inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-host-host-id path: /v3/global/asset/host/{host_id} operations: - name: v3-globaldata-asset-host method: GET description: Censys Get a Host inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: host_id in: path type: string required: true description: The IP address of a host. - name: at_time in: query type: string required: false 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. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-host-host-id-observations-services path: /v3/global/asset/host/{host_id}/observations/services operations: - name: v3-globaldata-service-on-host method: GET description: Censys Get Service History for a Host inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: start_time in: query type: string required: false 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 in: query type: string required: false 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 in: query type: integer required: false description: Number of results per page (max 100) - name: page_token in: query type: string required: false description: Pagination token from previous response - name: port in: query type: integer required: false description: Filter by port number - name: protocol in: query type: string required: false description: Filter by application protocol - name: transport_protocol in: query type: string required: false description: Filter by transport protocol - name: host_id in: path type: string required: true description: The IP address of a host. - name: order_by in: query type: - array - "null" required: false description: Order observations by these fields. Multiple values can be provided to sort by multiple fields (e.g., ['port DESC', 'protocol ASC']). outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-host-host-id-timeline path: /v3/global/asset/host/{host_id}/timeline operations: - name: v3-globaldata-asset-host-timeline method: GET description: Censys Get Host Event History inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: host_id in: path type: string required: true description: The IP address of a host. - name: start_time in: query type: string required: true 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 in: query type: string required: true 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. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-webproperty path: /v3/global/asset/webproperty operations: - name: v3-globaldata-asset-webproperty-list method: GET description: Censys Retrieve Multiple Web Properties inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: webproperty_ids in: query type: - array - "null" required: true description: A list of web property identifiers. - name: at_time in: query type: string required: false 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 outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-globaldata-asset-webproperty-list-post method: POST description: Censys Retrieve Multiple Web Properties inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-asset-webproperty-webproperty-id path: /v3/global/asset/webproperty/{webproperty_id} operations: - name: v3-globaldata-asset-webproperty method: GET description: Censys Get a Web Property inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: webproperty_id in: path type: string required: true description: A web property identifier. - name: at_time in: query type: string required: false 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 outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-dns-resolutions-ip-ip-bounds path: /v3/global/dns/resolutions/ip/{ip}/bounds operations: - name: v3-globaldata-dns-ip-resolution-bound method: GET description: Censys Get Latest DNS Names That Resolved to an IP inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: start_time in: query type: string required: false 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 in: query type: string required: false 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 in: query type: integer required: false description: Number of results per page (max 100) - name: page_token in: query type: string required: false description: Pagination token from previous response - name: record_types in: query type: - array - "null" required: false description: Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted. - name: ip in: path type: string required: true description: The IP address of a DNS record. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-dns-resolutions-ip-ip-ranges path: /v3/global/dns/resolutions/ip/{ip}/ranges operations: - name: v3-globaldata-dns-ip-resolution-ranges method: GET description: Censys Get DNS Names That Resolved to an IP Within a Time Window inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: start_time in: query type: string required: false 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 in: query type: string required: false 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 in: query type: integer required: false description: Number of results per page (max 100) - name: page_token in: query type: string required: false description: Pagination token from previous response - name: record_types in: query type: - array - "null" required: false description: Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted. - name: domain in: query type: string required: false description: Filter to a specific domain name resolving to this IP. - name: ip in: path type: string required: true description: The IP address of a DNS record. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-dns-resolutions-name-bounds path: /v3/global/dns/resolutions/{name}/bounds operations: - name: v3-globaldata-dns-name-resolution-bound method: GET description: Censys Get Latest DNS Resolution Records for a Name inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: start_time in: query type: string required: false 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 in: query type: string required: false 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 in: query type: integer required: false description: Number of results per page (max 100) - name: page_token in: query type: string required: false description: Pagination token from previous response - name: record_types in: query type: - array - "null" required: false 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 in: path type: string required: true description: The domain name outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-dns-resolutions-name-ranges path: /v3/global/dns/resolutions/{name}/ranges operations: - name: v3-globaldata-dns-name-resolution-ranges method: GET description: Censys Get Historical DNS Resolution Ranges for a Name inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: start_time in: query type: string required: false 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 in: query type: string required: false 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 in: query type: integer required: false description: Number of results per page (max 100) - name: page_token in: query type: string required: false description: Pagination token from previous response - name: record_types in: query type: - array - "null" required: false 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 in: path type: string required: true description: The domain name outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-scans-rescan path: /v3/global/scans/rescan operations: - name: v3-globaldata-scans-rescan method: POST description: "Censys Live Rescan: Initiate a New Rescan" inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-scans-scan-id path: /v3/global/scans/{scan_id} operations: - name: v3-globaldata-scans-get method: GET description: Censys Get Scan Status inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: scan_id in: path type: string required: true description: The unique identifier of the tracked scan outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-search-aggregate path: /v3/global/search/aggregate operations: - name: v3-globaldata-search-aggregate method: POST description: Censys Aggregate Results for a Search Query inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-search-convert path: /v3/global/search/convert operations: - name: v3-globaldata-search-convert method: POST description: Censys Convert Legacy Search Queries to Platform Queries inputParameters: - name: organization_id in: query type: string required: true 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: v3-global-search-query path: /v3/global/search/query operations: - name: v3-globaldata-search-query method: POST description: Censys Run a Search Query inputParameters: - name: organization_id in: query type: string required: false 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: X-Organization-ID in: header type: string required: false 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. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter." - name: body in: body type: object required: true description: Request body. outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest namespace: platform-global-data-rest port: 8080 description: REST adapter for Censys Platform — Global Data. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/global/asset/certificate name: global-asset-certificate description: REST surface for global-asset-certificate. operations: - method: GET name: v3-globaldata-asset-certificate-list description: Censys Retrieve Multiple Certificates call: platform-global-data.v3-globaldata-asset-certificate-list with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID certificate_ids: rest.certificate_ids outputParameters: - type: object mapping: $. - method: POST name: v3-globaldata-asset-certificate-list-post description: Censys Retrieve Multiple Certificates call: platform-global-data.v3-globaldata-asset-certificate-list-post with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/asset/certificate/raw name: global-asset-certificate-raw description: REST surface for global-asset-certificate-raw. operations: - method: GET name: v3-globaldata-asset-certificate-list-raw description: Censys Retrieve Multiple Certificates in PEM Format call: platform-global-data.v3-globaldata-asset-certificate-list-raw with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID certificate_ids: rest.certificate_ids outputParameters: - type: object mapping: $. - method: POST name: v3-globaldata-asset-certificate-list-raw-post description: Censys Retrieve Multiple Certificates in PEM Format call: platform-global-data.v3-globaldata-asset-certificate-list-raw-post with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/asset/certificate/{certificate_id} name: global-asset-certificate-certificate-id description: REST surface for global-asset-certificate-certificate-id. operations: - method: GET name: v3-globaldata-asset-certificate description: Censys Get a Certificate call: platform-global-data.v3-globaldata-asset-certificate with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID certificate_id: rest.certificate_id outputParameters: - type: object mapping: $. - path: /v1/global/asset/certificate/{certificate_id}/raw name: global-asset-certificate-certificate-id-raw description: REST surface for global-asset-certificate-certificate-id-raw. operations: - method: GET name: v3-globaldata-asset-certificate-raw description: Censys Get a Certificate in PEM Format call: platform-global-data.v3-globaldata-asset-certificate-raw with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID certificate_id: rest.certificate_id outputParameters: - type: object mapping: $. - path: /v1/global/asset/host name: global-asset-host description: REST surface for global-asset-host. operations: - method: GET name: v3-globaldata-asset-host-list description: Censys Retrieve Multiple Hosts call: platform-global-data.v3-globaldata-asset-host-list with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID host_ids: rest.host_ids at_time: rest.at_time outputParameters: - type: object mapping: $. - method: POST name: v3-globaldata-asset-host-list-post description: Censys Retrieve Multiple Hosts call: platform-global-data.v3-globaldata-asset-host-list-post with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/asset/host/{host_id} name: global-asset-host-host-id description: REST surface for global-asset-host-host-id. operations: - method: GET name: v3-globaldata-asset-host description: Censys Get a Host call: platform-global-data.v3-globaldata-asset-host with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID host_id: rest.host_id at_time: rest.at_time outputParameters: - type: object mapping: $. - path: /v1/global/asset/host/{host_id}/observations/services name: global-asset-host-host-id-observations-services description: REST surface for global-asset-host-host-id-observations-services. operations: - method: GET name: v3-globaldata-service-on-host description: Censys Get Service History for a Host call: platform-global-data.v3-globaldata-service-on-host with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID start_time: rest.start_time end_time: rest.end_time page_size: rest.page_size page_token: rest.page_token port: rest.port protocol: rest.protocol transport_protocol: rest.transport_protocol host_id: rest.host_id order_by: rest.order_by outputParameters: - type: object mapping: $. - path: /v1/global/asset/host/{host_id}/timeline name: global-asset-host-host-id-timeline description: REST surface for global-asset-host-host-id-timeline. operations: - method: GET name: v3-globaldata-asset-host-timeline description: Censys Get Host Event History call: platform-global-data.v3-globaldata-asset-host-timeline with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID host_id: rest.host_id start_time: rest.start_time end_time: rest.end_time outputParameters: - type: object mapping: $. - path: /v1/global/asset/webproperty name: global-asset-webproperty description: REST surface for global-asset-webproperty. operations: - method: GET name: v3-globaldata-asset-webproperty-list description: Censys Retrieve Multiple Web Properties call: platform-global-data.v3-globaldata-asset-webproperty-list with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID webproperty_ids: rest.webproperty_ids at_time: rest.at_time outputParameters: - type: object mapping: $. - method: POST name: v3-globaldata-asset-webproperty-list-post description: Censys Retrieve Multiple Web Properties call: platform-global-data.v3-globaldata-asset-webproperty-list-post with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/asset/webproperty/{webproperty_id} name: global-asset-webproperty-webproperty-id description: REST surface for global-asset-webproperty-webproperty-id. operations: - method: GET name: v3-globaldata-asset-webproperty description: Censys Get a Web Property call: platform-global-data.v3-globaldata-asset-webproperty with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID webproperty_id: rest.webproperty_id at_time: rest.at_time outputParameters: - type: object mapping: $. - path: /v1/global/dns/resolutions/ip/{ip}/bounds name: global-dns-resolutions-ip-ip-bounds description: REST surface for global-dns-resolutions-ip-ip-bounds. operations: - method: GET name: v3-globaldata-dns-ip-resolution-bound description: Censys Get Latest DNS Names That Resolved to an IP call: platform-global-data.v3-globaldata-dns-ip-resolution-bound with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID start_time: rest.start_time end_time: rest.end_time page_size: rest.page_size page_token: rest.page_token record_types: rest.record_types ip: rest.ip outputParameters: - type: object mapping: $. - path: /v1/global/dns/resolutions/ip/{ip}/ranges name: global-dns-resolutions-ip-ip-ranges description: REST surface for global-dns-resolutions-ip-ip-ranges. operations: - method: GET name: v3-globaldata-dns-ip-resolution-ranges description: Censys Get DNS Names That Resolved to an IP Within a Time Window call: platform-global-data.v3-globaldata-dns-ip-resolution-ranges with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID start_time: rest.start_time end_time: rest.end_time page_size: rest.page_size page_token: rest.page_token record_types: rest.record_types domain: rest.domain ip: rest.ip outputParameters: - type: object mapping: $. - path: /v1/global/dns/resolutions/{name}/bounds name: global-dns-resolutions-name-bounds description: REST surface for global-dns-resolutions-name-bounds. operations: - method: GET name: v3-globaldata-dns-name-resolution-bound description: Censys Get Latest DNS Resolution Records for a Name call: platform-global-data.v3-globaldata-dns-name-resolution-bound with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID start_time: rest.start_time end_time: rest.end_time page_size: rest.page_size page_token: rest.page_token record_types: rest.record_types name: rest.name outputParameters: - type: object mapping: $. - path: /v1/global/dns/resolutions/{name}/ranges name: global-dns-resolutions-name-ranges description: REST surface for global-dns-resolutions-name-ranges. operations: - method: GET name: v3-globaldata-dns-name-resolution-ranges description: Censys Get Historical DNS Resolution Ranges for a Name call: platform-global-data.v3-globaldata-dns-name-resolution-ranges with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID start_time: rest.start_time end_time: rest.end_time page_size: rest.page_size page_token: rest.page_token record_types: rest.record_types name: rest.name outputParameters: - type: object mapping: $. - path: /v1/global/scans/rescan name: global-scans-rescan description: REST surface for global-scans-rescan. operations: - method: POST name: v3-globaldata-scans-rescan description: "Censys Live Rescan: Initiate a New Rescan" call: platform-global-data.v3-globaldata-scans-rescan with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/scans/{scan_id} name: global-scans-scan-id description: REST surface for global-scans-scan-id. operations: - method: GET name: v3-globaldata-scans-get description: Censys Get Scan Status call: platform-global-data.v3-globaldata-scans-get with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID scan_id: rest.scan_id outputParameters: - type: object mapping: $. - path: /v1/global/search/aggregate name: global-search-aggregate description: REST surface for global-search-aggregate. operations: - method: POST name: v3-globaldata-search-aggregate description: Censys Aggregate Results for a Search Query call: platform-global-data.v3-globaldata-search-aggregate with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/search/convert name: global-search-convert description: REST surface for global-search-convert. operations: - method: POST name: v3-globaldata-search-convert description: Censys Convert Legacy Search Queries to Platform Queries call: platform-global-data.v3-globaldata-search-convert with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - path: /v1/global/search/query name: global-search-query description: REST surface for global-search-query. operations: - method: POST name: v3-globaldata-search-query description: Censys Run a Search Query call: platform-global-data.v3-globaldata-search-query with: organization_id: rest.organization_id X-Organization-ID: rest.X-Organization-ID body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: platform-global-data-mcp port: 9090 transport: http description: MCP adapter for Censys Platform — Global Data. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: censys-retrieve-multiple-certificates description: Censys Retrieve Multiple Certificates hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-certificate-list with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID certificate_ids: tools.certificate_ids outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-certificates-2 description: Censys Retrieve Multiple Certificates hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-asset-certificate-list-post with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-certificates-pem description: Censys Retrieve Multiple Certificates in PEM Format hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-certificate-list-raw with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID certificate_ids: tools.certificate_ids outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-certificates-pem-2 description: Censys Retrieve Multiple Certificates in PEM Format hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-asset-certificate-list-raw-post with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-get-certificate description: Censys Get a Certificate hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-certificate with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID certificate_id: tools.certificate_id outputParameters: - type: object mapping: $. - name: censys-get-certificate-pem-format description: Censys Get a Certificate in PEM Format hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-certificate-raw with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID certificate_id: tools.certificate_id outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-hosts description: Censys Retrieve Multiple Hosts hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-host-list with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID host_ids: tools.host_ids at_time: tools.at_time outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-hosts-2 description: Censys Retrieve Multiple Hosts hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-asset-host-list-post with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-get-host description: Censys Get a Host hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-host with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID host_id: tools.host_id at_time: tools.at_time outputParameters: - type: object mapping: $. - name: censys-get-service-history-host description: Censys Get Service History for a Host hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-service-on-host with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID start_time: tools.start_time end_time: tools.end_time page_size: tools.page_size page_token: tools.page_token port: tools.port protocol: tools.protocol transport_protocol: tools.transport_protocol host_id: tools.host_id order_by: tools.order_by outputParameters: - type: object mapping: $. - name: censys-get-host-event-history description: Censys Get Host Event History hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-host-timeline with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID host_id: tools.host_id start_time: tools.start_time end_time: tools.end_time outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-web-properties description: Censys Retrieve Multiple Web Properties hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-webproperty-list with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID webproperty_ids: tools.webproperty_ids at_time: tools.at_time outputParameters: - type: object mapping: $. - name: censys-retrieve-multiple-web-properties-2 description: Censys Retrieve Multiple Web Properties hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-asset-webproperty-list-post with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-get-web-property description: Censys Get a Web Property hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-asset-webproperty with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID webproperty_id: tools.webproperty_id at_time: tools.at_time outputParameters: - type: object mapping: $. - name: censys-get-latest-dns-names description: Censys Get Latest DNS Names That Resolved to an IP hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-dns-ip-resolution-bound with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID start_time: tools.start_time end_time: tools.end_time page_size: tools.page_size page_token: tools.page_token record_types: tools.record_types ip: tools.ip outputParameters: - type: object mapping: $. - name: censys-get-dns-names-that description: Censys Get DNS Names That Resolved to an IP Within a Time Window hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-dns-ip-resolution-ranges with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID start_time: tools.start_time end_time: tools.end_time page_size: tools.page_size page_token: tools.page_token record_types: tools.record_types domain: tools.domain ip: tools.ip outputParameters: - type: object mapping: $. - name: censys-get-latest-dns-resolution description: Censys Get Latest DNS Resolution Records for a Name hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-dns-name-resolution-bound with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID start_time: tools.start_time end_time: tools.end_time page_size: tools.page_size page_token: tools.page_token record_types: tools.record_types name: tools.name outputParameters: - type: object mapping: $. - name: censys-get-historical-dns-resolution description: Censys Get Historical DNS Resolution Ranges for a Name hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-dns-name-resolution-ranges with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID start_time: tools.start_time end_time: tools.end_time page_size: tools.page_size page_token: tools.page_token record_types: tools.record_types name: tools.name outputParameters: - type: object mapping: $. - name: censys-live-rescan-initiate-new description: "Censys Live Rescan: Initiate a New Rescan" hints: readOnly: false destructive: false idempotent: false call: platform-global-data.v3-globaldata-scans-rescan with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-get-scan-status description: Censys Get Scan Status hints: readOnly: true destructive: false idempotent: true call: platform-global-data.v3-globaldata-scans-get with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID scan_id: tools.scan_id outputParameters: - type: object mapping: $. - name: censys-aggregate-results-search-query description: Censys Aggregate Results for a Search Query hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-search-aggregate with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-convert-legacy-search-queries description: Censys Convert Legacy Search Queries to Platform Queries hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-search-convert with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $. - name: censys-run-search-query description: Censys Run a Search Query hints: readOnly: true destructive: false idempotent: false call: platform-global-data.v3-globaldata-search-query with: organization_id: tools.organization_id X-Organization-ID: tools.X-Organization-ID body: tools.body outputParameters: - type: object mapping: $.