# EU VIES VAT Number Check API

> Validate EU VAT numbers and get the registered company name and address (all 27 states + XI)

- Vendor: `euviesvatnumbercheckapi` · version 1.0 · category Business · tags vat check api, vies api, eu vat validation api, vat number lookup api, kyb api, company verification api, b2b invoicing api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/euviesvatnumbercheckapi
- This document: https://apiclay.com/docs/euviesvatnumbercheckapi.md
- OpenAPI 3.1: https://apiclay.com/api/euviesvatnumbercheckapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `euviesvatnumbercheckapi`
- Updated: 2026-11-18

## About

## EU VIES VAT Number Check API

Check whether an EU VAT number is valid right now and get the name and address the member state has on record for it: the standard check for B2B invoicing, reverse charge and supplier onboarding. Covers the 27 EU states plus Northern Ireland (`XI`).

Data comes from **ec.europa.eu** (https://ec.europa.eu/taxation_customs/vies). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://ec.europa.eu/taxation_customs/vies) and returns it unchanged.

Typical flow: `/check` with the country code and the number without its prefix; `/status` when a country answers with a service error.

### Routes

#### GET `/check` - Check a VAT number
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| country | path | string | yes | Member state code, e.g. `IE`, `DE`, `FR` (`EL` for Greece, `XI` for Northern Ireland). |
| vat_number | path | string | yes | Number without the country prefix, e.g. `6388047V`. |

Returns: `isValid`, `name`, `address`, `requestDate`, `vatNumber`, and `userError` (`VALID`, `INVALID`, or a service error such as `MS_UNAVAILABLE`).

#### GET `/status` - Service status by country
No parameters.

Returns: `vow.available` and `countries[{countryCode, availability}]`.

### Caveats

- Some states (e.g. DE, ES) don't disclose the name and address; they answer `---`.
- A member state's database can be briefly unavailable; retry later or check `/status`.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by ec.europa.eu.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /check — Check a VAT number
- Gateway: `GET https://api.apiclay.com/v1/api/euviesvatnumbercheckapi/check`
- Public query params: `country` (string, required), `vat_number` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /status — Service status by country
- Gateway: `GET https://api.apiclay.com/v1/api/euviesvatnumbercheckapi/status`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/euviesvatnumbercheckapi/check?country=<country>&vat_number=<vat_number>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
