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).
30 requests per hour per IP · demo key used automatically
Authorization: Bearer <api_key> header. Use a vtv_live_* key in production or a vtv_test_* key for deterministic magic-number responses.Query parameters
endpointenumFilter by endpoint kind.
statusenum`ok` = stored 2xx envelope, `fail` = currently always empty (failures are not persisted yet); reserved for #3a follow-up.
fromstringISO 8601 lower bound on `created_at` (inclusive).
2026-04-01T00:00:00ZtostringISO 8601 upper bound on `created_at` (inclusive).
2026-04-30T23:59:59ZlimitintegerPage size; defaults to 50, max 100.
50cursorstringOpaque cursor (the previous page's `meta.next_cursor`).
Response
Audit records page
datarequiredarray<object>metarequiredobjectrequest_idrequiredstringnext_cursorrequiredstring | nullcountrequiredintegerError responses
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
}
}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.
BZSt §18e qualified VAT confirmation (German legal evidence)
Issues a qualified Bestätigungsmitteilung from the German Bundeszentralamt für Steuern (BZSt) confirming a foreign EU VAT and, field-by-field, whether the supplied company details match what the foreign registry has on file. The result is stored for 10 years as tax-audit evidence under §18e UStG. Business plan only. Supports `Idempotency-Key` header (UUID) for safe retries within 24 hours.