Quick start
This guide helps you make your first request to the VerifyVAT API in just a few minutes. If you haven't done so yet, create an account and log in.
First, go to the Profile › API Access section and copy your access key. You will need this key to authenticate every request. Keep it safe: anyone who has it can use it to consume your credit.
Once you have the key, you can query the main endpoint. The API accepts both GET
and POST
requests. The recommended method is POST
, so you can pass parameters in the request body.
Prepare your POST
call:
POST https://verifyvat.com/api/:tax-type/:tax-idContent-Type: application/jsonx-api-key: {api_key}
You can find a list of supported tax types in the Parameters section, or use auto
to let the API detect the correct type automatically.
If your application does not support POST
queries, you can still use GET
, but you will need to pass the parameters as a query string. Some advanced features may not be available in this mode.
Make the request. If everything is correct, you will receive a 200 OK
response with the requested data.
The response will be in JSON format. Here is a sample excerpt of a successful response for IT00743110157
(Tax type: it_vat
):
Verify the API's behavior in real-time using the playground. Requests made from the playground are not subject to the monthly quota.
You can check the status of your active plan and the requests made in Profile › Billing. Information about costs and monthly limits can be found on the Pricing page. Each plan includes a number of included monthly requests and a cost for extra requests, which are automatically counted.