Skip to content

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

idstringrequired
The domain ID (dom_…).

Query parameters

namestring
Record name to match, such as @ or www. A full name such as www.example.se also works.
typestring
Record type to match. Case does not matter. One of A, AAAA, CNAME, ALIAS, MX, TXT, NS, SRV, CAA, TLSA.
limitinteger
Events per page, from 1 to 100. Default 20. Default 20. 1 to 100.
cursorstring
The nextCursor value from the previous page.

Example

GET /api/v2/domains/{id}/dns/history
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.

Response 200
{
"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 object
The events, newest first.
eventIdstring
The event ID (dnsevt_…). Snapshot rows carry the snapshot ID (dnss_…).
domainIdstring or null
The domain ID (dom_…). Null on snapshot rows.
domainstring
The domain name.
actorTypestring
Who 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 null
The account that made the change. Set only for customer and api.
requestIdstring or null
The request ID of the call that made the change, when known.
orderIdstring or null
The order the change came from, such as a DNS copy at checkout. Null otherwise.
ticketIdstring or null
The support ticket the change came from. Null otherwise.
createdAtstring
When the change was made.
changeTypestring
What kind of change it was. Snapshots appear as import. One of create, update, delete, import, replace_zone, nameserver_change.
sourceFlowstring
Machine name of the flow that made the change, such as dns_record_update. Snapshot rows use dns_snapshot_<source>.
summarystring
A readable sentence about the change.
beforeRrsetnull
The record set before the change. Null for a new record.
afterRrsetnull
The record set after the change. Null for a deleted record.
beforeNameserversarray of any or null
Nameservers before a nameserver change.
afterNameserversarray of any or null
Nameservers after a nameserver change.
hasMoreboolean
True when more events 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.

400type, limit 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.