Validate an intra-community VAT number
An intra-community VAT number cannot be checked with a formula: it is verified against VIES, the European Commission service that queries the tax administration of the member state concerned. /v1/tva/verifier/{numero} makes that call and returns the consultation identifier, which is the auditable trace of the check.
See a real response (free) Get the quote for /v1/tva/verifier/{numero}
Two states, and an outage is not one of them
The answer is valid or invalid. When VIES or a member state's administration is down, the route gives no verdict: it answers with a 503 amont_indisponible error, not billed, to retry later. Many integrations collapse that outage into “invalid” for simplicity, and then block compliant customers every time an administration has an outage. We refuse that collapse: it is a design decision, not an implementation detail.
Keep the VIES consultation identifier with your accounting entry. It is what proves, months later, that the check really was performed on that date.
Validating is not matching: the limit to know
VIES answers “this number is assigned and active”. It does not answer “this number belongs to the company you think”. Depending on the member state, the name and address returned are partial or absent. If your need is to know whether the number matches this supplier, you must cross-check the registry: that is what /v1/facture/verifier does, recomputing the number from the company identifier.
When to use it, and when not to pay
- Use it before invoicing under an intra-community exemption, when onboarding a new business customer, and when checking an incoming invoice.
- No need to pay if you only want to compute a French VAT number from a company number: the key derives from the number, and our identity routes already return it.
- Re-run it periodically on recurring customers: a number valid today can be revoked tomorrow, and it is the buyer who carries the risk.
How you pay
Every route is paid per call, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota. Over x402, the first call returns a 402 quote your client settles, then replays the call. A failed call is never billed.
Open today: 150 free calls a month with an account, up to EUR 2 of value, on 122 of 129 routes (the price list says which), with 100 more free lines a month on batch identity, and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.
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 and in llms.txt.
One call, end to end
# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534
# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
Routes used and pricing
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/tva/verifier/{numero} | $0.003 | free sample | EU VAT validation against the official VIES service: validate any intra-community VAT number (all member states) for compliance and due diligence, the tax half of verify supplier before payment and a required check under the e-invoicing mandate France September 2026. Returns valid/invalid with the VIES consultation identifier as proof. Name and address only for a holder that its number's format or its country's register proves a legal person; otherwise left out, counted in ecartes. |
/v1/facture/verifier | $0.02 | free sample | Invoice verification for France: cross-check the identifiers PRINTED ON an invoice in one call: SIREN against the official registry (existence, active status, live), the VAT number on the invoice against the one computed from the SIREN AND live against VIES, the IBAN (ISO form, key digits, bank identified). Deterministic verdict coherent/incoherent/inverifiable, closed-list reasons. Flags a VAT that belongs to another company or a ceased supplier. Not a payee verification. |
/v1/facturation/dossier | $0.03 | free sample | Invoice verification and supplier verification: verify supplier before payment in France, the invoicing pack of the e-invoicing mandate France September 2026 (all VAT-liable companies must receive): legal identity, obligation dates, intra-EU VAT number checked LIVE against VIES, IBAN form + key check, bank identified, deterministic pret_a_facturer verdict, closed-list reasons. Not a payee verification: no holder name, no account existence check. A VIES outage never yields a false invalid. |
The IBAN check is not a payee verification: neither the account holder's name nor the account's existence is checked (verification_titulaire: non_disponible).
Sirenic is not an accredited French e-invoicing platform (PDP), never accesses the central directory, and neither issues, transmits nor routes any invoice.
Frequently asked questions
Are all member states covered?
Yes, validation goes through VIES, which covers all member states. The quality of the additional information returned (name, address) depends on each national administration.
What happens if VIES is down?
On /v1/tva/verifier, the answer is a 503 amont_indisponible error, not billed; in an invoicing file or an invoice check, the VAT is marked indisponible and the reason tva_non_verifiable says so. Retry later: never treat that answer as a refusal.
Take it further
The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota.
See a real response (free) Get the quote for /v1/tva/verifier/{numero} Read the route reference Create an account: 150 free calls a month up to EUR 2 of value