---
title: "DNS record history."
method: GET
path: "/api/history/{domain}"
tags: ["domain"]
---

# DNS record history.

`GET /api/history/{domain}`

Returns the DNS history for the given domain and its subdomains.

The `type` codes can be found here: [https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml](https://www.iana.org/assignments/dns-parameters/dns-parameters.xhtml).

The `time` field is the time in Unix timestamp when the record last seen.

# Note
- **EXPERIMENTAL FEATURE!**
- The subdomain part will be trimmed (eg.: `/api/history/totally.invalid.elmasy.com` will be the same as `/api/lookup/elmasy.com`).
- If `domain` not found, the server saves for later process.

## Path parameters

- `domain` string, required

## Query parameters

- `days` integer

## Response `200`

success

- object[]
  - `domain` string
  - `records` Record[]
    - `type` integer
    - `value` string
    - `time` integer

## Other responses

- `400` — Invalid domain or days
- `404` — No records found.
- `500` — Internal Server Error.
- `502` — Bad Gateway. Upstream failed.
- `504` — Gateway Timeout. Upstream response takes too long.

---

[API](https://skmtc.net/elmasy-com/apis/columbus-api.md) · [All operations](https://skmtc.net/elmasy-com/apis/columbus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elmasy-com/columbus-api/versions/afcfa121a5e2/schema)