Check EU VAT numbers
check_vat_numbersRead-onlyIdempotent
Use this when the user asks for a vat number check, vies vat validation, or eu vat number lookup with dated XLSX and CSV logs. Checks 1 to 100 EU or XI VAT numbers against published structures and live VIES; no national checksum test. Do not use for deciding whether reverse charge applies.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| numbers | Yes | The VAT numbers with country prefixes, 1 to 100 items of 4 to 40 characters; for example ["IE6388047V", "fr 40 303265045"]. | |
| requester_vat | No | Your own EU business VAT number with country prefix for consultation numbers; for example IE6388047V. Leave out to check without requester details. | |
| default_country | No | Country code for a number without a prefix; for example IE. Use EL for Greece. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rows | Yes | ||
| summary | Yes | ||
| warnings | Yes | ||
| downloads | Yes | ||
| availability | Yes | ||
| retrievedUtc | Yes |