What counts as an API request?

Plans & billing

What counts as an API request?

Only calls to the validation endpoint (/v1/vat/:vatId) count against your monthly quota. The VAT rates endpoint (/v1/rates) and dashboard/account API calls are free and don’t count.

What is charged

A request consumes a quota slot only when it returns an actual valid/invalid determination. Each of these is a real answer, so each counts as one request:

  • a single call to /v1/vat/:vatId;
  • each VAT ID in a bulk job – every unique number counts once, the same as a single call, with no per-batch surcharge.

What is not charged

  • A malformed request rejected as INVALID_FORMAT – it is rejected before any quota is reserved.
  • A VIES_UNAVAILABLE outage, or any other upstream failure – the reservation is refunded.
  • A quota-exceeded 429 – by definition it never reserved a slot.
  • Test-mode calls with test keys – they never touch your quota. See test mode.

Tracking your count

Every live response carries RateLimit-* headers, so you can see how many requests you have left without opening the dashboard. The pricing page lists the monthly quota for each plan.

Related questions