Skip to content

List account audit events

GET /api/v2/audit-log

Lists what happened on the account, newest first. Events are requests made in the client area or with API keys. DNS changes are listed too, with their before and after values. Each event has a readable summary, a category and the changes it made, next to the raw method and endpoint. Without startAt the list covers the last 12 hours. Set hideGet=true to leave out read-only requests. Page with cursor and nextCursor (Pagination). Responses are cached for up to 2 minutes.

Authentication: An API key with the scope audit:read. About keys and scopes

Request

Query parameters

limitinteger
Events per page, 1 to 100. Default 50. Other values return 400 invalid_request. Default 50. 1 to 100.
cursorstring
The nextCursor value from the previous page. A cursor the list cannot read returns the first page, with no error.
startAtstring
Earliest event time, ISO 8601, inclusive. Default: 12 hours ago.
endAtstring
Latest event time, ISO 8601, inclusive.
severitystring
Only events with this severity, such as info, warning, error or critical. DNS change events are always info.
methodstring
Only events with this HTTP method, in any case. Overrides hideGet. DNS change events match POST (create, import, nameserver change), PUT or PATCH (update, zone replacement) and DELETE.
endpointstring
Text to match in the endpoint path, in any case. For DNS change events it matches the domain name or the summary.
hideGetboolean
true leaves out read-only GET requests. Ignored when method is set. Default false. Default false.
includeStatsboolean
true adds the stats counters. Default false. Default false.
includeDnsEventsboolean
false leaves out DNS change events. Default true. Default true.

Example

GET /api/v2/audit-log
curl "https://cloud.hostup.se/api/v2/audit-log" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 One page of audit events.

Response 200
{
"data": [
{
"id": "dnsevt_01hxa3b4c5d6e7f8g9h0j1k2m3",
"occurredAt": "2026-10-30T09:55:01.000Z",
"method": "PUT",
"endpoint": "/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dns/history",
"path": "/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dns/history",
"ipAddress": null,
"userAgent": null,
"statusCode": 200,
"success": true,
"durationMs": null,
"errorMessage": null,
"authMethod": "api-key",
"resourcesAccessed": [
"domain:dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"dns:example.com"
],
"severity": "info",
"tags": [
"dns_history",
"dns_update",
"dns_record_update"
],
"eventSource": "dns_history",
"actorType": "api",
"actorId": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3",
"category": "dns",
"action": "dns_record_update",
"summary": "Changed A www for example.com from 192.0.2.10 to 192.0.2.20.",
"resourceLabel": "example.com",
"changes": [
{
"label": "Values",
"before": "192.0.2.10",
"after": "192.0.2.20"
}
],
"requestId": "3f2b8c1e-6d4a-4f7b-9a2e-5c8d1e0f7a3b"
},
{
"id": "b95de54b-2d8d-45f1-96b9-2d2e5a3c02fb",
"occurredAt": "2026-10-30T09:55:00.000Z",
"method": "PUT",
"endpoint": "/api/v2/dns-zones/zone_01hxa3b4c5d6e7f8g9h0j1k2m3/records/drr_01hxa3b4c5d6e7f8g9h0j1k2m4",
"path": "/api/v2/dns-zones/zone_01hxa3b4c5d6e7f8g9h0j1k2m3/records/drr_01hxa3b4c5d6e7f8g9h0j1k2m4",
"ipAddress": "198.51.100.25",
"userAgent": "curl/8.7.1",
"statusCode": 200,
"success": true,
"durationMs": 214,
"errorMessage": null,
"authMethod": "api-key",
"resourcesAccessed": [
"v2_dns_zone:zone_01hxa3b4c5d6e7f8g9h0j1k2m3:record_update"
],
"severity": "info",
"tags": [
"v2_dns_record_update"
],
"eventSource": "request_audit",
"actorType": null,
"actorId": null,
"category": "dns",
"action": "dns_record_update",
"summary": "Saved DNS record A www -> 192.0.2.20.",
"resourceLabel": "drr_01hxa3b4c5d6e7f8g9h0j1k2m4",
"changes": [
{
"label": "Type",
"before": null,
"after": "A"
},
{
"label": "Name",
"before": null,
"after": "www"
},
{
"label": "Value",
"before": null,
"after": "192.0.2.20"
},
{
"label": "TTL",
"before": null,
"after": "3600"
}
]
}
],
"total": 2,
"hasMore": false,
"nextCursor": null
}
Response fields
dataarray of object
idstring
Event ID. DNS change events have a dnsevt_… ID.
occurredAtstring
When the event happened.
methodstring
HTTP method of the request.
endpointstring
API path of the request.
pathstring
Requested path.
ipAddressstring or null
IP address the request came from. null on DNS change events.
userAgentstring or null
User agent of the request. null on DNS change events.
statusCodeinteger or null
HTTP status the request got.
successboolean
true when the request succeeded.
durationMsinteger or null
Time the request took, in milliseconds.
errorMessagestring or null
Error text of a failed request.
authMethodstring or null
How the request was authenticated, such as session or api-key.
resourcesAccessedarray of string
Resources the request touched.
severitystring
info, warning, error or critical.
tagsarray of string
Labels for the event.
eventSourcestring
request_audit for a request. dns_history for a DNS change with before and after values. One of request_audit, dns_history.
actorTypestring or null
Who made a DNS change: customer, staff (Hostup support), system, api or smartcopy (records copied automatically from the domain’s previous DNS). null on request events. One of customer, staff, system, api, smartcopy.
actorIdstring or null
Account ID (acct_…) of a customer or api actor on DNS change events.
requestIdstring or null
ID of the request behind a DNS change (its X-Request-ID), when known.
categorystring
Event group. One of dns, domain, security, billing, api, account.
actionstring
What was done, such as dns_record_update.
summarystring
Readable sentence about what happened.
resourceLabelstring or null
Name of the thing that changed, such as a domain or a record ID.
changesarray of object
Before and after values the API could derive.
labelstring
What changed, such as Values or TTL.
beforestring or null
Value before the change. null when unknown or new.
afterstring or null
Value after the change. null when removed or unknown.
totalinteger
Number of matching events.
hasMoreboolean
true when another page follows.
nextCursorstring or null
Cursor for the next page. null on the last page.
statsobject
Activity counters, only with includeStats=true. They count from startAt onward and ignore endAt and the other filters. totalEvents includes DNS change events. The other counters cover requests only.
totalEventsinteger
Events since startAt.
failedLoginsinteger
Failed log-ins since startAt.
apiCallsinteger
API requests since startAt.
securityEventsinteger
Failed requests and events with severity warning or higher.
avgResponseTimeMsinteger
Average request time in milliseconds.
topEndpointsarray of object
The ten most used endpoints.
endpointstring
countinteger
recentActivityarray of object
Events per hour for the latest 12 hours with activity.
datestring
countinteger

Errors

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

400A query parameter is invalid, such as limit outside 1 to 100 or a startAt that is not a date.
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.
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.