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
limitintegerEvents per page, 1 to 100. Default 50. Other values return 400
invalid_request. Default 50. 1 to 100.cursorstringThe
nextCursor value from the previous page. A cursor the list cannot read returns the first page, with no error.startAtstringEarliest event time, ISO 8601, inclusive. Default: 12 hours ago.
endAtstringLatest event time, ISO 8601, inclusive.
severitystringOnly events with this severity, such as
info, warning, error or critical. DNS change events are always info.methodstringOnly 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.endpointstringText to match in the endpoint path, in any case. For DNS change events it matches the domain name or the summary.
hideGetbooleantrue leaves out read-only GET requests. Ignored when method is set. Default false. Default false.includeStatsbooleantrue adds the stats counters. Default false. Default false.includeDnsEventsbooleanfalse leaves out DNS change events. Default true. Default true.Example
curl "https://cloud.hostup.se/api/v2/audit-log" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 One page of audit events.
{ "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 objectidstringEvent ID. DNS change events have a
dnsevt_… ID.occurredAtstringWhen the event happened.
methodstringHTTP method of the request.
endpointstringAPI path of the request.
pathstringRequested path.
ipAddressstring or nullIP address the request came from.
null on DNS change events.userAgentstring or nullUser agent of the request.
null on DNS change events.statusCodeinteger or nullHTTP status the request got.
successbooleantrue when the request succeeded.durationMsinteger or nullTime the request took, in milliseconds.
errorMessagestring or nullError text of a failed request.
authMethodstring or nullHow the request was authenticated, such as
session or api-key.resourcesAccessedarray of stringResources the request touched.
severitystringinfo, warning, error or critical.tagsarray of stringLabels for the event.
eventSourcestringrequest_audit for a request. dns_history for a DNS change with before and after values. One of request_audit, dns_history.actorTypestring or nullWho 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 nullAccount ID (
acct_…) of a customer or api actor on DNS change events.requestIdstring or nullID of the request behind a DNS change (its
X-Request-ID), when known.categorystringEvent group. One of
dns, domain, security, billing, api, account.actionstringWhat was done, such as
dns_record_update.summarystringReadable sentence about what happened.
resourceLabelstring or nullName of the thing that changed, such as a domain or a record ID.
changesarray of objectBefore and after values the API could derive.
labelstringWhat changed, such as
Values or TTL.beforestring or nullValue before the change.
null when unknown or new.afterstring or nullValue after the change.
null when removed or unknown.totalintegerNumber of matching events.
hasMorebooleantrue when another page follows.nextCursorstring or nullCursor for the next page.
null on the last page.statsobjectActivity 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.totalEventsintegerEvents since
startAt.failedLoginsintegerFailed log-ins since
startAt.apiCallsintegerAPI requests since
startAt.securityEventsintegerFailed requests and events with severity
warning or higher.avgResponseTimeMsintegerAverage request time in milliseconds.
topEndpointsarray of objectThe ten most used endpoints.
endpointstringcountintegerrecentActivityarray of objectEvents per hour for the latest 12 hours with activity.
datestringcountintegerErrors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | A query parameter is invalid, such as limit outside 1 to 100 or a startAt that is not a date. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller. |
| 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. |