ATverify
API referenceAudit

List recent audit records for the calling key

Returns the most recent audit records for the calling API key, newest first. Filterable by endpoint and date range. Cursor pagination via `meta.next_cursor` (pass it as `cursor=` on the next call).

Try it live
playground
Query

30 requests per hour per IP · demo key used automatically

Auth
Requires the Authorization: Bearer <api_key> header. Use a vtv_live_* key in production or a vtv_test_* key for deterministic magic-number responses.

Query parameters

endpointenum

Filter by endpoint kind.

statusenum

`ok` = stored 2xx envelope, `fail` = currently always empty (failures are not persisted yet); reserved for #3a follow-up.

fromstring

ISO 8601 lower bound on `created_at` (inclusive).

example 2026-04-01T00:00:00Z
tostring

ISO 8601 upper bound on `created_at` (inclusive).

example 2026-04-30T23:59:59Z
limitinteger

Page size; defaults to 50, max 100.

example 50
cursorstring

Opaque cursor (the previous page's `meta.next_cursor`).

200

Response

Audit records page

datarequiredarray<object>
metarequiredobject
meta.request_idrequiredstring
meta.next_cursorrequiredstring | null
meta.countrequiredinteger

Error responses

401Missing or invalid API key
402Free plan: audit_log retention is zero
import { Vatverify } from '@vatverify/node';
const client = new Vatverify();

const result = await client.listAuditLogs();
{
  "data": [
    {
      "request_id": "9b8e1a2c-4d6f-4e0b-9b2a-1c3d5e7f9a2b",
      "endpoint": "validate",
      "created_at": "…",
      "status_code": 0,
      "latency_ms": 0,
      "valid": true
    }
  ],
  "meta": {
    "request_id": "9b8e1a2c-4d6f-4e0b-9b2a-1c3d5e7f9a2b",
    "next_cursor": "…",
    "count": 0,
    "latency_ms": 47
  }
}