Skip to content

List DNS changes for a domain

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

List the changes to a domain’s DNS records and nameservers, newest first. Each event says who or what made the change (actorType), what kind of change it was (changeType) and gives a one-line summary. Record changes carry the record set before and after (beforeRrset, afterRrset). Nameserver changes carry beforeNameservers and afterNameservers. Saved copies of the zone, for example from before a transfer, appear as import events. To follow one record, use GET /api/v2/domains/{id}/dns/history with its name and type filters. Page with limit and cursor (Pagination). A key limited to certain DNS records needs access to the whole zone to read this.

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
Events per page, from 1 to 100. Default 50. Default 50.
cursorstring
The nextCursor from the previous page.

Example

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

Responses

200 One page of DNS change events.

Response 200
{
"data": [
{
"eventId": "dnsevt_01hxa3b4c5d6e7f8g9h0j1k2m3",
"domainId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"domain": "example.com",
"actorType": "customer",
"actorId": "acct_01hxa3b4c5d6e7f8g9h0j1k2m5",
"requestId": "req_01hxa3b4c5d6e7f8g9h0j1k2m3",
"orderId": null,
"ticketId": null,
"createdAt": "2026-05-19T09:55:00.000Z",
"changeType": "update",
"sourceFlow": "dns_record_update",
"summary": "Changed A record @ -> 192.0.2.10 for example.com.",
"beforeRrset": {
"name": "@",
"type": "A",
"values": [
"198.51.100.10"
],
"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
eventIdstring
The event ID.
domainIdstring or null
The domain ID. Null on saved zone copies.
domainstring
The domain name.
actorTypestring
Who made the change. customer: someone logged in to the client area. api: an API key. staff: Hostup support. system: Hostup automatically. smartcopy: an automatic copy of records, for example when a domain moved to Hostup. One of customer, staff, system, api, smartcopy.
actorIdstring or null
The account that made the change, for customer and api. Null otherwise.
requestIdstring or null
The ID of the request that made the change, if known.
orderIdstring or null
The order that made the change, if any.
ticketIdstring or null
The support ticket the change belongs to, if any.
createdAtstring
When the change was made.
changeTypestring
What kind of change it was. One of create, update, delete, import, replace_zone, nameserver_change.
sourceFlowstring
A short code for the action that made the change.
summarystring
One English sentence describing the change.
beforeRrsetnull
The record set before the change. Null when the change created it.
afterRrsetnull
The record set after the change. Null when the change deleted it.
beforeNameserversarray of any or null
The nameservers before a nameserver change.
afterNameserversarray of any or null
The nameservers after a nameserver change.
hasMoreboolean
True when there are more events.
nextCursorstring or null
Pass as cursor to get 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 is outside 1 to 100, or cursor cannot be read.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
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.