Check VAT ID
check_vat_idChecks one EU VAT ID (27 member states plus XI) or one Swiss UID live in the official register (VIES or the Swiss UID register). Returns valid / invalid / unavailable / format_error, the registered name and address where published, the source with the time of the check (UTC) and a ready-to-file record. Accepts any common spelling (spaces, dots, dashes, lower case, 'MWST'). Use before reverse-charge invoices or to verify a business partner.
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_id": "<vat_id>"
},
"name": "check_vat_id"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vat_id | Yes | The VAT ID or Swiss UID, with country prefix, e.g. DE123456788, ATU12345675 or CHE-123.456.788 MWST. | |
| with_receipt | No | Optional, default false. Set true only when the user asks for a signed receipt of this check for their files. | |
| expected_city | No | Optional: expected city, compared by VIES. | |
| expected_name | No | Optional: the company name you expect. VIES compares it with the register where the country supports this (e.g. Spain). | |
| expected_street | No | Optional: expected street, compared by VIES. | |
| requester_vat_id | No | Optional: the user's OWN EU VAT ID. If given, VIES returns a consultation number as official proof of the check. Only pass it when the user provided their own VAT ID for this purpose. | |
| expected_postal_code | No | Optional: expected postal code, compared by VIES. |