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://do
# --- truncated at 32 KB (76 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/censys/refs/heads/main/capabilities/platform-global-data.yaml