Skip to content

Get the DNS snapshot from before Hostup

GET /api/v2/domains/{id}/dns/snapshots/latest-before-hostup

Returns the DNS records the domain had at its previous DNS provider, from the most reliable snapshot taken while it still used other nameservers. Use it to find the old website or mail server addresses after a move to Hostup nameservers. When no such snapshot exists the call returns 200 with available: false and a reason.

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

Request

Path parameters

idstringrequired
The domain ID (dom_…).

Example

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

Responses

200 The snapshot. When there is none, available is false and reason says why.

Response 200
{
"available": true,
"snapshot": {
"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"
},
"reason": null
}
Response fields
availableboolean
True when a snapshot was found.
snapshotobject or null
The snapshot. Null when none was found.
reasonstring or null
Why no snapshot is available. Null when available is true.

Errors

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

400Invalid request. The response body is an RFC 7807 Problem Details document.
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.