Sign in

v1

latestOpenAPI 3.1.02026-07-2481742657.4 KB
Global Data

Get DNS resolution records for a name (ranges)

Retrieve the records that resolved for a name during a time frame. This endpoint returns 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.<br><br>Record results are broken down based on time range. 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 return one row for each of those distinct ranges for the 1.1.1.1 A record.<br><br>To retrieve records for a name with each result aggregated per record, use the bounds endpoint 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/{name}/ranges

Path parameters

namestring required

The domain name

Example:platform.censys.io

The domain name

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, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted.

Filter by record types (A, AAAA, MX, NS, SOA, TXT). For multiple values, include comma-separated values. Defaults to all supported types when omitted.

[
  "MX"
]

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 DNS resolution observations for the provided name.