Get your customer base ready for e-invoicing

“Here is my customer export: complete and correct SIREN, SIRET and VAT.” With French e-invoicing, the customer's SIREN becomes a mandatory mention on the invoice, and invoices are routed by SIREN and SIRET. Are all my customers identified the way the invoice requires? Which ones have a wrong, missing or outdated SIREN, or a VAT number that does not check out? Paste your customer export in Claude, as your software exports it, and ask: every line comes back at its rank, completed and checked, and nothing is chosen for you.

See a real response (free) Get the quote for /v1/identite/lot

What Claude calls, and what it reads

Claude reads the export and takes one line per record: the SIREN, the SIRET, the French VAT number, or the name and postcode when the line has no identifier. It calls the get_french_company_identity_batch tool, which serves the /v1/identite/lot route, 2 to 150 lines per tool call (the route takes 300: a full batch takes 2 tool calls). For each line, the answer gives:

• the line's rank in your file and what was read: siren, siret, tva or nom_cp; the typed name is never echoed;
• the resolution, from a closed list: resolu, a_confirmer, introuvable, siren_invalide, siren_inconnu, non_diffusible;
• for a resolved line: the SIREN, the head-office SIRET, the legal name, the status (actif or cesse, with the cessation date when it is published) and the head-office address;
• VAT: the number computed from the SIREN and its VIES status at the time of the call, valide, invalide, indisponible or non_verifie; a VIES that does not answer gives indisponible, never invalide;
• an ambiguous name comes back a_confirmer with up to 5 candidates ranked by score; a line that points to a company already seen above carries doublon_de, the rank of the first one.

A name is resolved only when a single company bears that name (legal name, usual name or acronym) at that postcode, with every index stage read. Otherwise the line comes back to confirm, with its candidates, or not found: never a silent choice.

A five-line export

Five neutral lines, one per input form, taken from our reference set of companies; the last one is an invented name. No customer data.

What comes back was read on 2026-10-09 with our test key, in Claude, on the Sirene stock of 2026-10-01; the VIES status is the one at the time of the call. These five lines fit in one call of a verified account's free quota; outside it, they cost $0.015.

Limits, measured

• VAT is checked live on VIES, line by line, one at a time: in French business hours, VIES serves one verdict every 4 to 5 s and refuses concurrency; before pipelined checks, a full batch had 15 of 262 resolved lines checked; with them, outside business hours (23:51 UTC), 105 of 265; measured 2026-10-08. A line whose check could not start in time says so (non_verifie, budget_vies_epuise): run those lines again in a smaller batch, or outside business hours.
• A batch has 60 s, 40 s of which to find names. A name line whose index stage could not be read in time says so (etages_abandonnes) and is never resolu; the batch head counts them. On the full batch of 300 names of 2026-10-08 (23:51 UTC), 9 lines of 300 said so.
• The cessation date is read live, for ceased lines only; when it is missing, the line says why: non_publiee, source_indisponible or budget_lot_epuise.
• 2 to 300 lines per call; the request line is capped at 11,000 bytes, that is 300 SIRENs or about 148 names of 63 characters; beyond that, a requete_trop_large refusal; beyond about 16 KB, an empty 431; neither is billed.

What the route does not do

It neither creates nor checks any registration in the e-invoicing directory: Sirenic is not an accredited platform, the route prepares your base, it sends no invoice. It never chooses between two namesakes. A natural person's name is never resolved: a sole trader is not served as a candidate, and their SIREN line comes back without name or address.

What an export costs

Up to 50 lines per call, the batch is in the free quota of verified accounts: one of the month's 150 free calls, no credit debited, and the five example lines cost nothing there. Beyond 50 lines, or outside the quota, the batch is billed $0.003 per line, duplicates included: $0.015 for the five example lines, $0.90 for a full batch of 300 lines, with prepaid credits (card top-up is not open yet), or over x402 for the same amount in USDC or EURC. A refused or unavailable batch is never billed.

The same batch, without an assistant

The five example lines, encoded the way the MCP tool encodes them; the API key is read from the SIRENIC_KEY variable.

# The five example lines, 2 to 300 per call
curl "https://api.sirenic.eu/v1/identite/lot?lignes=552032534%3B55203253400711%3BFR48056200454%3BAIR+LIQUIDE+CO2+EUROPE%7C75007%3BQXZJW+VKPRT%7C33000" \
  -H "X-Api-Key: $SIRENIC_KEY"

# Over MCP, on the connector https://api.sirenic.eu/mcp/connecteur (tools/call method),
# the key in an Authorization: Bearer $SIRENIC_KEY header, or Claude's OAuth connection
{"name": "get_french_company_identity_batch", "arguments": {"lignes": ["552032534", "55203253400711", "FR48056200454", "AIR LIQUIDE CO2 EUROPE|75007", "QXZJW VKPRT|33000"]}}

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.

Open today: 150 free calls a month with an account, on 105 of 121 routes (the price list says which), 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

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

My export only has company names: does it work?

Yes, with the head-office postcode: write the line name|postcode. The rule, case by case: a single company found at that postcode, with every index stage read, a legal entity whose register entry is public and whose legal name, usual name or acronym is the typed name, cleaned: resolu; the same single company, under another name: a_confirmer, that company as the only candidate; several companies found, or companies found with an index stage not read in time, or found only by tolerating typos: a_confirmer, with, as candidates, the legal entities found whose register entry is public; a single company found that is not a legal entity whose register entry is public: a_confirmer, with no candidate served; no company found: introuvable, with the index stages not read, if any. Measured on 2026-10-08: two names typed with their postcode came back a_confirmer, each with a single company found under another name, as the only candidate; no SIREN chosen. With often ambiguous names, the tool advises 50 lines per call: each line to confirm carries its candidates.

What about the e-invoicing directory?

The route neither reads it nor registers anything in it: it is reserved to accredited platforms. It gives you the SIREN and head-office SIRET, the identifiers invoices are routed by; to prepare an invoice customer by customer, see invoice preparation in the routes table.

My sales team has the same base in its CRM?

The same route answers it, with the same answer: the page “Enrich and clean your CRM” starts from the question asked before a campaign, ceased companies and duplicates.

Take it further

No account to create, no key to request: the first step is free and shows you exactly what you would be buying.

See a real response (free) Get the quote for /v1/identite/lot Read the route reference Create an account: 150 free calls a month

Read next

• Enrich and clean your CRM
• Preparing supplier master data for the French e-invoicing mandate
• Validate an intra-community VAT number

OpenAPI · llms.txt · Full route catalogue and pricing