Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Global Data

Get DNS names that resolved to an IP (aggregated bounds)

Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with record_types (A or AAAA).<br><br>Results are aggregated per domain name and multiple distinct ranges for a name will be grouped into one row of results. For example, if censys.com resolved to 1.1.1.1 from January 1 to January 7 during two different ranges of January 1 to January 3 and January 5 to January 7, and you targeted January 1 through January 7 with your API call, then this endpoint will group those ranges into one entry for censys.com in the response.<br><br>To retrieve domain names for an IP with each record broken down by time range, use the ranges endpoint<br><br>This endpoint is only available to organizations on the Censys Search and Censys Core plans.<br><br>Learn more about Censys Active DNS.

get/v3/global/dns/resolutions/ip/{ip}/bounds

Path parameters

ipstring ip required

The IP address of a DNS record.

Example:8.8.8.8

The IP address of a DNS record.

Query parameters

organization_idstring uuid required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

start_timestring

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.

Example:2024-01-01T00:00:00Z

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.

end_timestring

End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.

Example:2024-01-31T23:59:59Z

End of date range (RFC3339 format, e.g., 2024-01-31T23:59:59Z). If not specified, defaults to now. Cannot be in the future.

page_sizeinteger

Number of results per page (max 100)

Example:50

Number of results per page (max 100)

page_tokenstring

Pagination token from previous response

Pagination token from previous response

record_typesstring[] nullable

Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted.

Filter by record types (A, AAAA). For multiple values, include comma-separated values. Defaults to A and AAAA when omitted.

[
  "A"
]

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Response

A list of domain names that resolved to the provided IP.