# DNS History

Returns the historical DNS records Deepinfo has observed for a domain or FQDN, including values that have since changed or been removed (passive DNS).

Source: https://docs.deepinfo.com/reference/lookup/dns-history/

Last updated: 2026-09-27

---
`GET https://api.deepinfo.com/v1/analyze/dns-history`

Returns the **historical** DNS records Deepinfo has observed for a domain or FQDN, including values that have since changed or been removed (passive DNS). Use it to see how a domain's hosting, mail and name servers changed over time.

## Authentication

Send your API key in the `apikey` request header.

## Query Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `domain` | Required | Domain name or FQDN, e.g. `deepinfo.com` or `www.deepinfo.com`. IP addresses are not accepted. | `deepinfo.com` |
| `type` | Optional | Record type to return, for example `A`. Omit to return every type. | `A` |

## Response Fields

| Field | Description |
|---|---|
| `fqdn` | The queried name |
| `dn` | Its registered domain |
| `subdomain` | Subdomain part, or `null` |
| `records[]` | One entry per record type |
| `records[].type` | Record type, in lower case, for example `a` or `mx` |
| `records[].values[]` | One entry per distinct value seen for that type |
| `records[].values[].value` | The value |
| `records[].values[].time` | Every time (UTC, newest first) that value was observed |

## Response Schema

_Inferred from examples._ Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

| Field | Type |
|---|---|
| `fqdn` | string |
| `dn` | string |
| `subdomain` | null |
| `records` | array<object> |
| `records[].type` | string |
| `records[].values` | array<object> |
| `records[].values[].value` | string |
| `records[].values[].time` | array<string> |

## Errors

`400` if `domain` is not a valid FQDN.

## Examples

### 200 · A Records

```bash
curl 'https://api.deepinfo.com/v1/analyze/dns-history?domain=deepinfo.com&type=A' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'
```

`Content-Type: application/json` · `ratelimit-limit: 1` · `ratelimit-remaining: 0` · `ratelimit-reset: 1` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "fqdn": "deepinfo.com",
  "dn": "deepinfo.com",
  "subdomain": null,
  "records": [
    {
      "type": "a",
      "values": [
        {
          "value": "104.26.10.21",
          "time": [
            "2026-09-18T05:41:26Z",
            "2026-09-05T21:26:18Z",
            "2026-08-16T16:37:59Z"
          ]
        },
        {
          "value": "104.26.11.21",
          "time": [
            "2026-09-18T05:41:26Z",
            "2026-09-05T21:26:18Z",
            "2026-08-16T16:37:59Z"
          ]
        },
        {
          "value": "172.67.70.198",
          "time": [
            "2026-09-18T05:41:26Z",
            "2026-09-05T21:26:18Z",
            "2026-08-16T16:37:59Z"
          ]
        }
      ]
    }
  ]
}
```

## Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and its response: [DNS History Examples](/reference/lookup/dns-history/examples/).

- [Every Record Type of a Domain](/reference/lookup/dns-history/examples/all-types/): Every record type Deepinfo has seen for deepinfo.com: A, AAAA, MX, NS, SOA, TXT and HINFO, each with its values over time.
- [A Record History of a Domain](/reference/lookup/dns-history/examples/type-a/): The A record history of deepinfo.com: nine IPv4 addresses, from 192.185.32.176 (2017 to 2019) to the three current Cloudflare addresses.
- [Name Server History: HostGator to Cloudflare](/reference/lookup/dns-history/examples/type-ns/): The NS history of deepinfo.com: HostGator name servers from 2018 to September 2019, Cloudflare name servers since January 2021.