Check an EU VAT number in VIES
vat_checkCheck whether a VAT number was valid for intra-EU transactions according to VIES, the European Commission's VAT Information Exchange System, on request_date. Results are cached for 24 hours. Use it when the user asks whether a VAT number (NIF-IVA) is valid for intra-EU trade. For a Spanish NIF, use company_by_nif to look for a company with that NIF in our registry.
Returns JSON {vat_number, country_code, number, valid, request_date, source, note}. Relay note as given: the check does not identify the holder, and a negative result says nothing about the domestic tax identifier. invalid_input true: relay tell_the_user. error vies_unavailable or vat_check_rate_limited: the check could not be made now; do not call the number valid or invalid.
Read-only. Needs the basic plan or higher: send your API key in the X-API-Key header (https://bormeapi.com/account).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vat_number": "<vat_number>"
},
"name": "vat_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vat_number | Yes | EU VAT number with its two-letter country code, e.g. ESA28015865 or DE123456789. Spaces, dots and hyphens are ignored; GR is read as EL; a Spanish NIF without a prefix is checked as ES. |