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
idstringrequiredThe domain ID (
dom_…).Query parameters
limitintegerSnapshots per page, from 1 to 100. Default 10. Default
10. 1 to 100.cursorstringThe
nextCursor value from the previous page.Example
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.
{ "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 objectThe snapshots, newest first.
idstringThe snapshot ID (
dnss_…).domainIdstring or nullThe domain ID (
dom_…).domainstringThe domain name.
capturedAtstringWhen the records were read.
sourcestringWhy 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 nullWhere the records were read, such as the old nameserver and its address. Null when unknown.
rrsetsarray of objectThe record sets in the snapshot.
namestringtypestringOne of
A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA.valuesarray of stringttlinteger or nullpriorityinteger or nullweightinteger or nullportinteger or nullproxiedboolean or nullconfidencestringWhere 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.hasMorebooleanTrue when more snapshots follow.
nextCursorstring or nullPass 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.
| 400 | limit or cursor is not valid. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. 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. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is domain_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |