---
title: "Get DNS resolution records for a name (aggregated bounds)"
method: GET
path: "/v3/global/dns/resolutions/{name}/bounds"
tags: ["Global Data"]
---

# Get DNS resolution records for a name (aggregated bounds)

`GET /v3/global/dns/resolutions/{name}/bounds`

Retrieve the DNS resolution records for a name. 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>Results are aggregated per record distinct ranges for a record 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 the `1.1.1.1` A record in the response.<br><br>To retrieve records for a name with each record broken down by time range, use the [ranges endpoint](https://docs.censys.com/reference/v3-globaldata-dns-name-resolution-ranges).<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](https://docs.censys.com/docs/platform-active-dns).

## Path parameters

- `name` string, required — The domain name

## Query parameters

- `organization_id` string, uuid, required — 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.
- `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` integer — Number of results per page (max 100)
- `page_token` string — Pagination token from previous response
- `record_types` string[], 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.

## Headers

- `X-Organization-ID` string, uuid — 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.

## Response `200`

A list of DNS records currently resolving for the provided name.

- ResponseEnvelopeDnsNameResolutionBoundResponse
  - `result` DnsNameResolutionBoundResponse
    - `name` string, required — The domain name that was queried.
    - `next_page_token` string, required — A token that can be used to retrieve the next page of records.
    - `records` DnsResolutionRecord[], nullable, required — The list of DNS records.
      - `first_seen` string, date-time, required — The time this record was first observed.
      - `ip` string — The IP of the record. IPv4 if the record_type is A. IPv6 if the record_type is AAAA. Otherwise not present.
      - `last_seen` string, date-time, required — The time this record was last observed.
      - `mail_server` string — The MX mail server. Only present when record_type is MX. Otherwise not present.
      - `mname` string — The primary name server. Only present when record_type is SOA. Otherwise not present.
      - `name_server` string — The name server. Only present when record_type is NS. Otherwise not present.
      - `priority` integer — The MX priority. Only present when record_type is MX. Otherwise not present.
      - `record_type` 'A' | 'AAAA' | 'MX' | 'NS' | 'SOA' | 'TXT', required — The record type. Either A, AAAA, MX, NS, SOA, or TXT.
      - `rname` string — The responsible contact, as email. Only present when record_type is SOA. Otherwise not present.
      - `value` string — Full, untruncated string. Only present when record_type is TXT. Otherwise not present.
    - `total_records` integer, required — The number of records that exist in total across all pages.

## Other responses

- `400` — Bad request
- `401` — Request does not contain a valid Authorization token
- `403` — User does not have permission to access this data
- `404` — Resource not found
- `409` — Feature not enabled
- `500` — Internal server error

---

[API](https://skmtc.net/censys/apis/censys-platform-api.md) · [All operations](https://skmtc.net/censys/apis/censys-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/censys/censys-platform-api/revisions/261c916bf05b/schema)