sirenic

Verify a supplier before you pay them

Before a first transfer, three questions decide: does this company exist and is it still trading, is its VAT number valid today, and is this IBAN at least structurally plausible and attached to a known bank? The /v1/facturation/dossier route answers all three in one call and returns a closed-list verdict, not prose to interpret.

See a real response (free) Get the quote for /v1/facturation/dossier

What the check catches, and what it cannot catch

The pret_a_facturer verdict is deterministic: the same inputs always give the same output, and every refusal carries a reason drawn from a closed list. That is what lets you wire it into an approval workflow without a human re-reading each response.

The IBAN check is a form check: ISO 13616 structure, mod-97 key digits, bank identified against official registries. It is not a payee verification: neither the account holder's name nor the account's existence is checked, and the response says so (verification_titulaire: non_disponible). Against bank-details fraud it reduces the risk; it does not remove it.

A VIES outage never yields a false “invalid”

This is the most important design point of this route, and what separates a usable check from a dangerous one. When the European VIES service is unavailable (which happens regularly, member state by member state), the response returns unavailable, never invalid. A fully compliant supplier therefore cannot be blocked by an outage that is not theirs.

Consequence for your workflow: treat unavailable as “retry later”, not as a refusal. The reason is explicit precisely so your code can tell the difference.

The data behind the verdict

The identity check draws on 30,148,401 French company numbers, of which 16,742,414 are active and 8,966,557 are active legal entities, plus 44,282,364 establishments. The identity stock is re-ingested from official publications; the date of the last successful load is shown in the footer.

The full check's price is the /v1/facturation/dossier line in the table below. At that price, checking every new supplier costs less than reversing a single transfer.

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

RoutePriceSampleWhat it returns
/v1/facturation/dossier$0.03free sampleInvoice 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.
/v1/eu/facturation/dossier$0.03free sampleEuropean supplier and invoice verification for e-invoicing compliance in Belgium (mandate since 1 Jan 2026) and Poland (KSeF): registry identity, VIES VAT check, IBAN form + key, bank and, in Poland, the official White List: is the IBAN DECLARED by the taxpayer? Paying an undeclared account over 15,000 PLN costs the VAT deduction and joint liability. Natural person or doubtful form (BE, PL): no name or address (ecartes). Deterministic verdict, closed-list reasons.
/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/iban/verifier/{iban}$0.005free sampleIBAN verification and bank validation for SEPA payments: a FORM check to verify a supplier before payment: ISO 13616 structure + mod-97 key, plus bank identification from FREE official sources (FR via ACPR/REGAFI incl. LEI and SIREN; BE NBB; AT OeNB incl. LEI; NL BIC list; DE Bundesbank file). French BICs via GLEIF/SWIFT BIC-to-LEI. NOT a payee verification for instant payments: neither the holder name nor the account's existence is checked (verification_titulaire: non_disponible).
/v1/kyb/{siren}$0.15free sampleCompany lookup KYB: Know Your Business verification of a French company in one call, official company data for due diligence, compliance and customer onboarding: identity, officers, BODACC legal alerts (insolvency, deregistration), commercial-court decisions (Judilibre), filed financials, sanctions screening of the company and each officer against the 6 official lists, computed VAT number, completeness score. Per-block provenance (official register, as-of). Fully disclosed legal persons only.

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

Does this replace the payee verification required for instant payments?

No, and the response says so itself. We check the IBAN's form and identify the bank; we verify neither the holder's name nor the account's existence. Payee verification is a service only your payment provider can deliver, because only they can query the account-servicing institution.

Do I need an account or an API key?

No. The route answers 402 with a quote, your client settles in USDC or EURC on Base, then replays the call. No sign-up, no prior contract, no IP address to declare.

What if the supplier is established outside France?

Use /v1/eu/facturation/dossier, which covers Belgium (mandate live since 1 January 2026) and Poland (KSeF, including the official White List check: is the IBAN declared by the taxpayer?). Paying an undeclared account above PLN 15,000 costs the buyer the VAT deduction and triggers joint liability.

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/facturation/dossier Read the route reference Create an account: 150 free calls a month up to EUR 2 of value

Read next

Volume figures on this page were measured in our database on 2026-10-18. They are dated snapshots, not live counters. · OpenAPI · llms.txt · Full route catalogue and pricing