The organisation's audit log, newest first.
const url = 'https://api.opdns.io/v1/auth/audit?limit=50';const options = { method: 'GET', headers: {cookie: '__Host-opdns_session=<__Host-opdns_session>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.opdns.io/v1/auth/audit?limit=50' \ --cookie __Host-opdns_session=<__Host-opdns_session>Token scope: account:read. Append-only entries for sign-ins and failures,
credential and session changes, token create and revoke, profile, node,
export and deletion events of the caller’s organisation. Filtered
(0.42.0) by actor, action and time; filters combine. Each entry names
the email of the organisation’s account that acted (actor_email).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Page size.
The next_cursor of the previous page (opaque).
Who acted: an exact actor (account:<id>, token:<id>, system, …), or an
email address (holding @, case-insensitive), which selects the entries of the
organisation’s account with that email and of its API tokens. An email no
account of the organisation has matches nothing.
An exact action (auth.login), or a prefix ending in . (auth.).
Entries at or after this time (RFC 3339, or Unix milliseconds).
Entries before this time (RFC 3339, or Unix milliseconds); after from.
Responses
Section titled “Responses”A page of entries.
object
object
Who acted: account:<id>, token:<id>, system, ddns, …
What happened, e.g. auth.login, auth.login_failed, token.create,
profile.delete. profile.update (name, security, parental, settings,
rules or lists changed) carries a compact diff in meta: section
(profile, rules or lists), version, and for profile a changes
map of <section>.<field> (or name) to {from, to} or, for list-valued
fields, {added, removed}; for rules deny/allow/rewrites and for
lists the top level hold {added, removed} (at most 20 entries each,
with added_count/removed_count when capped).
What it happened to, e.g. session:<id>, profile:<id>.
object
The email of the organisation’s account that acted (0.42.0): the
account of an account:<id> actor, the owner of a token:<id> actor, as it is
now. Absent for other actors, for accounts since deleted, and for accounts of
another organisation (an operator).
Cursor of the next page (pass it as cursor); null on the last page.
Example
{ "entries": [ { "id": 812, "org_id": "6f1d2c3b-4a59-4e7d-8c1b-2a3f4e5d6c7b", "actor": "account:0b9a8c7d-6e5f-4a3b-9c2d-1e0f9a8b7c6d", "action": "profile.update", "target": "profile:abc123", "meta": { "section": "profile", "version": 7, "changes": { "settings.block_mode": { "from": "nxdomain", "to": "refused" } } }, "at": "2026-09-29T12:00:00Z" } ], "next_cursor": null}Malformed request.
object
Stable machine code.
object
Seconds, repeating the Retry-After header (rate limits, offline nodes).
The plan limit a plan_limit problem hit.
object
The plan’s value of the limit.
Where to move to a larger plan.
The scope the API token lacked (insufficient_scope).
Example
{ "type": "https://opdns.io/problems/bad_request", "title": "Bad Request", "status": 400, "code": "bad_request", "detail": "We couldn't read the request because its JSON isn't valid (unexpected end of JSON input). Please fix it and try again.", "request_id": "5f2c9a0e7b1d4c38"}Not authenticated.
object
Stable machine code.
object
Seconds, repeating the Retry-After header (rate limits, offline nodes).
The plan limit a plan_limit problem hit.
object
The plan’s value of the limit.
Where to move to a larger plan.
The scope the API token lacked (insufficient_scope).
Example
{ "type": "https://opdns.io/problems/unauthenticated", "title": "Unauthorized", "status": 401, "code": "unauthenticated", "detail": "You're not signed in, or your sign-in has ended. Please sign in again to continue.", "request_id": "5f2c9a0e7b1d4c38"}Authenticated but not allowed: insufficient_scope, session_required, csrf_rejected, reauth_required (sign in again within five minutes), account_pending_deletion (the account is in its deletion cooling-off), email_unverified (creating a profile before the email address is verified).
object
Stable machine code.
object
Seconds, repeating the Retry-After header (rate limits, offline nodes).
The plan limit a plan_limit problem hit.
object
The plan’s value of the limit.
Where to move to a larger plan.
The scope the API token lacked (insufficient_scope).
Example
{ "type": "https://opdns.io/problems/insufficient_scope", "title": "Forbidden", "status": 403, "code": "insufficient_scope", "detail": "This API token isn't allowed to do this: it needs the profiles:write scope. Create a token that includes it, then try again.", "required_scope": "profiles:write", "request_id": "5f2c9a0e7b1d4c38"}Field validation failed (validation_failed, unknown_list), or the organisation’s plan does not allow the write (plan_limit, naming the limit in limit).
object
Stable machine code.
object
Seconds, repeating the Retry-After header (rate limits, offline nodes).
The plan limit a plan_limit problem hit.
object
The plan’s value of the limit.
Where to move to a larger plan.
The scope the API token lacked (insufficient_scope).
Example
{ "type": "https://opdns.io/problems/validation_failed", "title": "Unprocessable Content", "status": 422, "code": "validation_failed", "detail": "Some of what you sent needs fixing. The list of errors says what to change.", "errors": [ { "field": "settings.block_mode", "message": "one of nxdomain, refused, null, block-page" } ], "request_id": "5f2c9a0e7b1d4c38"}