# Validate a VAT number at VIES

Three states, never two: valid, invalid, unavailable. Many integrations collapse the third into the second for simplicity, and then block compliant customers whenever a member state's administration has an outage. We refuse that collapse.

## What the route returns

Catalogue description, exactly as agents read it:

**EU VAT validation against the official VIES service: validate any intra-community VAT number (all member states) for compliance and due diligence. This tax id check is the tax half of verify supplier before payment, and a required check under the e-invoicing mandate France September 2026. Returns valid/invalid/unavailable status with the VIES consultation identifier as proof — VAT number validation usable across Europe for KYB and supplier onboarding.**

## Expected identifier

An intra-community VAT number, country prefix included.

> ⚠️ A wrongly formatted identifier returns `400` and is **not billed** — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes.

## Extract from a genuinely paid response

Dated snapshot from 2026-07-29, truncated to one item per array. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "numero": "FR27552032534",
 "pays": "FR",
 "statut": "valide",
 "nom": "SA DANONE",
 "adresse": "59 RUE LA FAYETTE 75009 PARIS",
 "request_identifier": null,
 "verifie_le": "2026-07-29T07:29:08.915Z",
 "valide": true,
 "source": "VIES — Commission européenne (service officiel de validation TVA)",
 "disclaimer": "Statut au moment de la consultation ; en cas d'indisponibilité du service de l'État membre, le statut est `indisponible` (jamais un faux invalide)."
}
```

## Price and billing

Price: **$0.003**. The authoritative amount is the one in the `402` quote returned by the route itself — not this text, which derives from the same grid but is still just a page.

An error response **cancels the payment**: a `400`, `404` or `503` is never billed. An upstream outage closes the route with a `503` rather than serving a degraded response.

## Calling the route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/tva/verifier/{numero}

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/tva/verifier/{numero}

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## What this route does not do

VIES answers “this number is assigned and active”. It does **not** answer “this number belongs to the company you think” — depending on the state, the name returned is partial or absent. For matching, cross-check the registry.

## Neighbouring routes

- `/v1/facture/verifier` — $0.02
- `/v1/facturation/dossier` — $0.03

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/tva/verifier/{numero}` | $0.003 | EU VAT validation against the official VIES service: validate any intra-community VAT number (all member states) for compliance and due diligence. This tax id check is the tax half of verify supplier before payment, and a required check under the e-invoicing mandate France September 2026. Returns valid/invalid/unavailable status with the VIES consultation identifier as proof — VAT number validation usable across Europe for KYB and supplier onboarding. |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/tva-verifier-numero.json)
- [Get the quote for /v1/tva/verifier/{numero}](https://api.sirenic.eu/v1/tva/verifier/{numero})
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

## Read next

- [Validate an intra-community VAT number](https://api.sirenic.eu/en/use-cases/validate-intra-community-vat-number-against-vies-pay-per)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/