List DNS history for a domain
GET /api/v2/domains/{id}/dns/history
Lists changes to the domain’s DNS records and nameservers, newest first. Each event shows what changed, who changed it and the record set before and after. Filter by record name and type to follow one record, such as the root A record or the www CNAME. Without a filter the list also holds DNS snapshots, such as the records seen before a nameserver change or a transfer. GET /api/v2/domains/{id}/dns/audit returns the same events without filters.
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
namestringRecord name to match, such as
@ or www. A full name such as www.example.se also works.typestringRecord type to match. Case does not matter. One of
A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA.limitintegerEvents per page, from 1 to 100. Default 20. Default
20. 1 to 100.cursorstringThe
nextCursor value from the previous page.Example
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dns/history" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 One page of DNS history events.
{ "data": [ { "eventId": "dnsevt_01hxa3b4c5d6e7f8g9h0j1k2m3", "domainId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3", "domain": "example.com", "actorType": "api", "actorId": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3", "requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3", "orderId": null, "ticketId": null, "createdAt": "2026-05-19T10:02:00.000Z", "changeType": "update", "sourceFlow": "dns_record_update", "summary": "Changed A record @ -> 192.0.2.10 for example.se.", "beforeRrset": { "name": "@", "type": "A", "values": [ "198.51.100.40" ], "ttl": 3600 }, "afterRrset": { "name": "@", "type": "A", "values": [ "192.0.2.10" ], "ttl": 3600 }, "beforeNameservers": null, "afterNameservers": null } ], "hasMore": false, "nextCursor": null}Response fields
dataarray of objectThe events, newest first.
eventIdstringThe event ID (
dnsevt_…). Snapshot rows carry the snapshot ID (dnss_…).domainIdstring or nullThe domain ID (
dom_…). Null on snapshot rows.domainstringThe domain name.
actorTypestringWho made the change:
customer (signed in to the client area), api (an API key), staff (Hostup support), system (an automatic process) or smartcopy (records copied from the previous DNS provider). One of customer, staff, system, api, smartcopy.actorIdstring or nullThe account that made the change. Set only for
customer and api.requestIdstring or nullThe request ID of the call that made the change, when known.
orderIdstring or nullThe order the change came from, such as a DNS copy at checkout. Null otherwise.
ticketIdstring or nullThe support ticket the change came from. Null otherwise.
createdAtstringWhen the change was made.
changeTypestringWhat kind of change it was. Snapshots appear as
import. One of create, update, delete, import, replace_zone, nameserver_change.sourceFlowstringMachine name of the flow that made the change, such as
dns_record_update. Snapshot rows use dns_snapshot_<source>.summarystringA readable sentence about the change.
beforeRrsetnullThe record set before the change. Null for a new record.
afterRrsetnullThe record set after the change. Null for a deleted record.
beforeNameserversarray of any or nullNameservers before a nameserver change.
afterNameserversarray of any or nullNameservers after a nameserver change.
hasMorebooleanTrue when more events 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 | type, 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. |