API Reference

Get DNS names that resolved to an IP (ranges)

get
https://api.platform.censys.io/v3/global/dns/resolutions/ip//ranges

Retrieve the domain names that resolved to an IP during a time frame. You can narrow results with record_types (A or AAAA).

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.

To retrieve domain names for an IP with each result aggregated by name, use the bounds endpoint endpoint.

This endpoint is only available to organizations on the Censys Search and Censys Core plans.

Learn more about Censys Active DNS.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The IP address of a DNS record.

Query Params
uuid
required

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

string

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.

string

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

int32
1 to 100
Defaults to 100

Number of results per page (max 100)

string

Pagination token from previous response

record_types
array of strings | null

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

record_types
Allowed:
string

Filter to a specific domain name resolving to this IP.

Headers
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.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated 3 months ago

Did this page help you?