API referenceWebhooks
List registered webhook endpoints
Returns all webhook endpoints for the authenticated key. Secrets are never returned.
Try it live
playgroundNo input required. Click Send to hit the endpoint.
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.200
Response
List of registered endpoints
datarequiredarray<object>Error responses
401Missing or invalid API key
402Plan does not include webhooks — Pro or Business required
import { Vatverify } from '@vatverify/node';
const client = new Vatverify();
const result = await client.listWebhooks();{
"data": [
{
"id": "019d917e-4fa4-766e-9e0f-d977b47bf2c6",
"url": "https://example.com/webhooks/vatverify",
"label": "…",
"enabled": true,
"last_delivery_at": "…",
"last_delivery_status": 0,
"created_at": "2026-04-15T10:00:00Z"
}
]
}