sirenic

Accountants: get your clients' customer bases ready for French e-invoicing

On 1 September 2027, French SMEs and micro-businesses will issue their invoices electronically, and the customer's SIREN becomes a mandatory mention on the invoice. The question reaches the accounting firm: is this client's customer base ready? Sirenic answers it from public registers. Submit the base, every line comes back at its rank with what the registers say, their source and their date; an ambiguous line comes back to confirm, and nothing is chosen for you.

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

What Sirenic reads for each customer

For each line of the file, Sirenic reads:

A name is resolved only when a single company bears it at that postcode. Otherwise the line comes back to confirm, with its candidates, or not found: never a silent choice. The line-by-line reading is detailed on the page "Get your customer base ready for e-invoicing".

What Sirenic does not do

Three steps

What is free

A Sirenic account, opened with an e-mail address and no card, gets 150 free calls a month on 106 of 122 routes (the price list says which). The identity batch is included up to 50 lines per call: 50 customers read in one call, no credit debited. Checking a VAT number, a customer's insolvency notices and its changes since a date are included too, one call each.

Outside the quota: an identity batch above 50 lines, the default-risk score, batch KYB and daily monitoring. They are paid with prepaid credits, whose card top-up is not open yet, or per call over x402 (USDC or EURC). A refused or failed call is never billed.

The file template

The "base clients prête" template has three columns for you (siren, denomination, code_postal) and eight that Sirenic fills (resolution, siren_sirenic, etat, tva, tva_vies, procedure, score, date_lecture). It holds no customer data: its example lines are public companies, an invented name and a SIREN with a wrong check digit.

Links: base-clients-prete.csv and base-clients-prete.xlsx.

Create my free key

In Excel, open the CSV through Data, then From Text, and set the siren and code_postal columns to text: otherwise a SIREN or postcode starting with 0 loses its zero. The spreadsheet already has these columns as text.

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 106 of 122 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

RoutePriceSampleWhat it returns
/v1/identite/lot$0.003 · $0.01 (with depuis) / entityfree sampleBatch identity for French customer/CRM lists: 2 to 300 lines (SIREN, SIRET, FR VAT number or name|postcode), in file order. Per line: resolution (resolu, a_confirmer with up to 5 ranked candidates, introuvable, siren_invalide, siren_inconnu, non_diffusible), SIREN, HQ SIRET, status, cessation date, address, VAT checked live on VIES (indisponible or budget_vies_epuise, never a false invalide), duplicates. $0.003 per line, up to $0.90; with depuis (changes since a date) $0.01, up to $3.00.
/v1/tva/verifier/{numero}$0.003free sampleEU 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/entreprise/{siren}/alertes$0.01free sampleLegal alerts for a French company from BODACC, the official French gazette of legal notices: insolvency proceedings (procedures collectives) and related court filings, deregistrations and business sales, grouped and most recent first. Check whether a French company is subject to collective proceedings before you contract — a due diligence, KYB and compliance signal for supplier onboarding and risk monitoring, drawn from official registry data.
/v1/entreprise/{siren}/changements$0.01free sampleCompany changes monitoring for a French company: the new official BODACC gazette announcements published SINCE a given date (?depuis=YYYY-MM-DD) — the poll endpoint for watchlist and portfolio surveillance. Returns the new announcements (insolvency, deregistration, sales, filings, changes) in reverse-chronological order. Note: detects new BODACC publications, not field-level edits of the Sirene/RNE profile (the monthly stock keeps no history).
/v1/score/defaillance/lot$0.07 / entityfree sampleBatch credit risk scoring of 2 to 100 French companies (comma-separated sirens): each line has the score, class and model version of GET /v1/score/defaillance/{siren} and a closed-list basket (expose, a_surveiller, sain, non_evaluable with its cause, cessee). Rank my customers by risk and monitor the 30 most exposed: chainage.surveillance lists the whole ranked expose basket (100 at most) with its 30-day quote, targets x unit price; keep the first 30. $0.07 per SIREN, unknown SIREN included.
/v1/kyb/batch$0.105 / entityfree sampleBatch KYB and bulk company lookup for 2 to 100 French companies in one call (comma-separated sirens): full KYB files with commercial-court decisions (Judilibre) and per-block provenance (official register, as-of date), for due diligence and compliance; or vue=synthese, one line per SIREN for a supplier list. Billed $0.105 per company (30% off the $0.15 unit price), quoted from the SIREN count. A SIREN with no diffusible company is returned as trouve=false and billed as one lookup.
/v1/surveillance/creer$0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entityfree sampleMonitoring for France: a 30, 90 or 365-day watchlist (?duree=) for KYB & compliance alerts, checked DAILY against official sources; Ed25519-signed webhook and/or e-mail digest, always pollable. Companies (SIREN): BODACC, status, officers, sanctions/AMF blacklist, PSAN/SGP, Seveso, commercial-court decisions, FR/EU procurement awards. Directors (dirigeant:Name): new/ended offices. Associations (RNA W…): JOAFE notices. Per target (1-100) x duration: $0.05 / $0.135 / $0.50. No account, no refund.

The default-risk score is a decision-support indicator. It is neither a solvency opinion nor a credit rating in the regulatory sense, and it guarantees no payment.

Frequently asked questions

How many customers does the free quota cover?

A 50-line batch counts as one call; reading the insolvency notices then counts one call per customer, as does each VAT number to check again. A 50-customer base read in full therefore fits in the month's 150 calls.

The base includes sole traders: does it work?

By SIREN, yes: the line comes back with its status, the head-office SIRET and the VAT number, without name or address. By name, no: a person's name is never resolved.

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

OpenAPI · llms.txt · Full route catalogue and pricing