ATverify
API referenceUsage

Per-day usage rollup for a key

Returns day-level rollups keyed by (day, endpoint, country, source) for one API key across a date range (≤ 90 days). Free plan returns 402.

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

key_idrequiredstring

API key to roll up. Must belong to the same user as the calling key.

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

Inclusive lower bound on day (YYYY-MM-DD).

example 2026-03-01
torequiredstring

Inclusive upper bound on day (YYYY-MM-DD). Range ≤ 90 days.

example 2026-03-31
200

Response

Rollup rows

datarequiredarray<object>
metarequiredobject
meta.request_idrequiredstring
meta.countrequiredinteger

Error responses

400Range too large or malformed
401Unauthorized
402Paid plan required
404Key not found or not owned by caller
import { Vatverify } from '@vatverify/node';
const client = new Vatverify();

const result = await client.getUsageRollup();
{
  "data": [
    {
      "day": "…",
      "endpoint": "validate",
      "country": "…",
      "source": "…",
      "count": 0,
      "success": 0
    }
  ],
  "meta": {
    "request_id": "9b8e1a2c-4d6f-4e0b-9b2a-1c3d5e7f9a2b",
    "count": 0,
    "latency_ms": 47
  }
}

Decide whether to charge VAT

Given seller and buyer VAT numbers, returns whether to charge VAT, at what rate, under which mechanism, with legal basis and invoice note. Requires a Business-plan API key. Shares the monthly quota pool with /v1/validate.

Validate up to 50 VAT numbers in one request

Validate up to 50 VAT numbers in a single request. Each item is normalized and routed to the correct registry (VIES/HMRC/BFS/BRREG) independently. Per-item successes and failures coexist in the 200 response under `data.results`. Cache hits do not count against your monthly quota. Pass `requester_vat_number` to obtain a per-item `verify_id` (VIES consultation number) for each EU result — useful for tax-audit trails. Calls with a requester always bypass the cache. Pro plan or Business plan required.