Skip to content

List DNS snapshots

GET /api/v2/domains/{id}/dns/snapshots

Lists saved copies of the domain’s DNS records, newest first. Snapshots are taken before a transfer, a nameserver change or a DNS record change. One is also taken when records are copied from the previous DNS provider and when a redirect replaces records. Use them to see what the records were at an earlier point. For the copy from before the domain moved to Hostup, use GET /api/v2/domains/{id}/dns/snapshots/latest-before-hostup.

Authentication: An API key with the scopes read:dns and read:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Query parameters

limitinteger
Snapshots per page, from 1 to 100. Default 10. Default 10. 1 to 100.
cursorstring
The nextCursor value from the previous page.

Example

GET /api/v2/domains/{id}/dns/snapshots
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dns/snapshots" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 One page of DNS snapshots.

Response 200
{
"data": [
{
"id": "dnss_01hxa3b4c5d6e7f8g9h0j1k2m3",
"domainId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"domain": "example.com",
"capturedAt": "2026-05-19T09:55:00.000Z",
"source": "pre_nameserver_change",
"providerHint": "ns1.old-provider.example (198.51.100.53)",
"rrsets": [
{
"name": "@",
"type": "A",
"values": [
"198.51.100.40"
],
"ttl": 300
},
{
"name": "www",
"type": "CNAME",
"values": [
"example.se"
],
"ttl": 300
},
{
"name": "@",
"type": "MX",
"values": [
"mail.example.se"
],
"ttl": 3600,
"priority": 10
}
],
"confidence": "authoritative"
}
],
"hasMore": false,
"nextCursor": null
}
Response fields
dataarray of object
The snapshots, newest first.
idstring
The snapshot ID (dnss_…).
domainIdstring or null
The domain ID (dom_…).
domainstring
The domain name.
capturedAtstring
When the records were read.
sourcestring
Why the snapshot was taken: pre_transfer (before a transfer), pre_nameserver_change (before a nameserver change), smartcopy_import (records copied from the previous DNS provider), pre_mutation (before a DNS record change), manual_scan (a one-off read of the domain’s DNS) or redirect_replace (records a redirect replaced, put back when the last redirect is removed). One of pre_transfer, pre_nameserver_change, smartcopy_import, pre_mutation, manual_scan, redirect_replace.
providerHintstring or null
Where the records were read, such as the old nameserver and its address. Null when unknown.
rrsetsarray of object
The record sets in the snapshot.
namestring
typestring
One of A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA.
valuesarray of string
ttlinteger or null
priorityinteger or null
weightinteger or null
portinteger or null
proxiedboolean or null
confidencestring
Where the records came from: authoritative (the domain’s own nameservers), resolver (a public DNS resolver), imported (an import) or user_supplied (entered by the customer). One of authoritative, resolver, imported, user_supplied.
hasMoreboolean
True when more snapshots follow.
nextCursorstring or null
Pass as cursor to read the next page. Null on the last page.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400limit or cursor is not valid.
401Unauthorized. Authentication is required.
403Forbidden. The API key lacks a required scope or covers only some DNS records. This call reads the whole DNS zone and needs access to all of it.
404Not found. The resource does not exist or is not owned by the caller; code is domain_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.