Parameters
To make a request to the VerifyVAT API, you will have to provide path parameters and, optionally, query parameters or a request body.
The recognized parameters differ depending on the request method, GET
or POST
.
:tax-type
This parameter specifies the type of tax ID you want to verify. It is a required path parameter and must be included in the URL.
You can explore the list of supported tax types visiting the Tax ID formats page. Here are some common examples:
Path param | Corresponding value | Country |
---|---|---|
auto | Automatically detect the correct tax type to use | Any |
it_vat | Partita IVA | Italy |
gb_vat | VAT number | United Kingdom |
de_vat | USt-IdNr. | Germany |
es_vat | NIF | Spain |
ch_vat | MWST-Nummer | Switzerland |
au_abn | ABN | Australia |
fr_vat | Numéro de TVA | France |
nl_vat | BTW-nummer | Netherlands |
be_vat | BTW-nummer | Belgium |
at_vat | UID | Austria |
pt_vat | NIF | Portugal |
se_vat | Momsregistreringsnummer | Sweden |
no_vat | MVA | Norway |
:tax-id
This parameter specifies the tax ID you want to verify. It is a required path parameter and must be included in the URL.
The format of the tax ID depends on the :tax-type
you are using. Make sure to provide a valid tax ID according to the rules of the corresponding country.
The easiest way to check the expected format is via our Playground, where you can select the tax type and see examples of valid tax IDs. Here are some examples of valid tax IDs for different tax types:
Tax type | Example value | Country |
---|---|---|
it_vat | IVAIT00743110157 | Italy |
gb_vat | VATGB 981 9284 72 | United Kingdom |
de_vat | Ust ID NrDE136695976 | Germany |
es_vat | NIFES J-99216582 | Spain |
ch_vat | UID/MWSTCHE-100.155.212 MWST | Switzerland |
au_abn | ABN83 914 571 673 | Australia |
fr_vat | TVAFR 40 303 265 045 | France |
nl_vat | BTWNL4495445B01 | Netherlands |
be_vat | TVABE0403019261 | Belgium |
at_vat | VATAT U13585627 | Austria |
pt_vat | NIFPT 501 964 843 | Portugal |
se_vat | VATSE 123456-7897 01 | Sweden |
no_vat | MVANO 995 525 828 MVA | Norway |
Please note that the tax ID should be sanitized before making the request. Remove any spaces, dashes, or special characters to ensure a valid format.
The tax ID is case-insensitive, so you can provide it in either uppercase or lowercase. The sanitized value for CHE-100.155.212 MWST
would be CHE100155212MWST
.
Business details
If you want the API to only check the format of the tax ID without verifying it against external databases, you can use the includeDetails
parameter. This parameter is optional and can be included in the request body for POST
requests or as a query parameter for GET
requests.
POST key | GET query param | Default value |
---|---|---|
includeDetails | details | true |