Error Reference
Every error response includes a machine-readablecode, a human-readable message, and a docs_url linking to the relevant page below.
All error codes
| Code | HTTP Status | Description |
|---|---|---|
missing_parameter | 400 | Required query parameter vat_number not provided |
invalid_vat_format | 422 | VAT number format unrecognized or country code unsupported |
unauthorized | 401 | Invalid or missing API key |
rate_limit_exceeded | 429 | Monthly quota exhausted |
burst_limit_exceeded | 429 | Per-minute burst limit exceeded |
upstream_error | 503 | HMRC returned an unexpected error |
upstream_unavailable | 503 | VIES or HMRC is unreachable |