API referenceAudit

Retrieve a past response by request_id

Returns the full response envelope for a previous validate, decide, or batch call. Records are retained for 7 days (Starter), 30 days (Pro), or 90 days (Business). Free plan keys always return 404.

Try it live

playground

Path

request_idrequiredstring

The playground demo key has its own tenant. Run GET /v1/validate, POST /v1/validate/batch, or POST /v1/decide first; the id will auto-fill here.

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.

Path parameters

request_idrequiredstring

The `meta.request_id` value from the original API response.

example 019d917e-4fa4-766e-9e0f-d977b47bf2c6

200

Response

Audit record found

datarequiredobject

data.request_idrequiredstring

example 019d917e-4fa4-766e-9e0f-d977b47bf2c6

data.endpointrequiredstring

one of"validate""decide""validate_batch""confirm"

data.responserequiredobject

The full original success response envelope.

data.created_atrequiredstring

example 2026-04-15T14:11:49.110Z

data.expires_atrequiredstring

example 2026-07-14T14:11:49.110Z

data.request_bodyany

The original request inputs (query string params or JSON body). Null on rows written before the column existed.

data.latency_msrequiredinteger | null

data.status_coderequiredinteger | null

data.validrequiredboolean | null

metarequiredobject

meta.request_idrequiredstring

meta.latency_msrequirednumber

Error responses

401Missing or invalid API key

404Record not found, expired, or belongs to a different key

import { Vatverify } from '@vatverify/node';
const client = new Vatverify();

const result = await client.getAuditLog();

{
  "data": {
    "request_id": "019d917e-4fa4-766e-9e0f-d977b47bf2c6",
    "endpoint": "validate",
    "response": {},
    "created_at": "2026-04-15T14:11:49.110Z",
    "expires_at": "2026-07-14T14:11:49.110Z",
    "request_body": null,
    "latency_ms": 0,
    "status_code": 0,
    "valid": true
  },
  "meta": {
    "request_id": "9b8e1a2c-4d6f-4e0b-9b2a-1c3d5e7f9a2b",
    "latency_ms": 47
  }
}

Python SDK

Official vatverify Python SDK, coming soon.

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).