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

get

https://api.platform.censys.io/v3/global/dns/resolutions/ip/{ip}/bounds

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

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.

To retrieve domain names for an IP with each record broken down by time range, use the ranges endpoint

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

Learn more about Censys Active DNS.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The IP address of a DNS record.

Query Params

organization_id

uuid

required

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

start_time

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.

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.

page_size

int32

1 to 100

Defaults to 100

Number of results per page (max 100)

page_token

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:

Headers

X-Organization-ID

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

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

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

400Bad request

401Request does not contain a valid Authorization token

403User does not have permission to access this data

404Resource not found

409Feature not enabled

500Internal server error