Veille

VAT Validation

GET
/v1/vat

Validate a European VAT number against the VIES database. Returns company name, registered address, and validity status for any EU member state.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The VAT number to validate (e.g. FR40303265045).

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
valid?boolean
vat_number?string
company_name?string
country_code?string
company_address?string
Example Request
curl -X GET 'https://api.veille.io/v1/vat?query=string'
Example Response
{  "valid": true,  "vat_number": "FR40303265045",  "company_name": "LVMH MOET HENNESSY LOUIS VUITTON",  "country_code": "FR",  "company_address": "22 AVE MONTAIGNE 75008 PARIS"}