Supplier-verification API before payment: identity, VAT, IBAN

GET/v1/facturation/dossier

Price: $0.03
Free quota: Included
Family: Invoice and pay

Parameters
Parameter	Where	Example
`siren`	query · required	`552032534`
`iban`	query · optional	`FR1420041010050500013M02606`

What is charged

200Ed25519-signed response, charged at the route's price
402Signed x402 quote, nothing is debited
4xxUnknown or invalid identifier, never charged
5xxUpstream source unavailable, never charged

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

curlx402MCPPythonJS

curl "https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606" \
  -H "X-Api-Key: $SIRENIC_KEY"

# 1. The quote, without paying anything: the route answers 402 with its amount
curl -i "https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606"

# Or over MCP, in Claude Code / Cursor / an agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

import os, requests

r = requests.get(
    "https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606",
    headers={"X-Api-Key": os.environ["SIRENIC_KEY"]},
)
print(r.json())

const r = await fetch("https://api.sirenic.eu/v1/facturation/dossier?siren=552032534&iban=FR1420041010050500013M02606", {
  headers: { "X-Api-Key": process.env.SIRENIC_KEY },
});
console.log(await r.json());

200 OK · extractx-credits-charged: 0.03

{
 "siren": "552032534",
 "destinataire": {
  "destinataire": {
   "denomination": "DANONE",
   "etat_administratif": "actif"
  }
 },
 "tva_vies": {
  "numero": "FR27552032534",
  "statut": "valide"
 },
 "banque": {
  "iban_normalise": "FR1420041010050500013M02606",
  "valide": true,
  "exemple_de_documentation": true,
  "banque": {
   "nom": "La Banque Postale",
   "bic": "PSSTFRPPXXX"
  },
  "verification_titulaire": "non_disponible"
 },
 "verdict": {
  "pret_a_facturer": true,
  "non_verifie": [
   "existence_du_compte",
   "nom_du_titulaire"
  ],
  "raisons": [
   {
    "code": "iban_exemple_documentation",
    "niveau": "information",
    "source": "IBAN publié comme EXEMPLE de documentation — bien formé ; existence du compte non contrôlée."
   }
  ]
 },
 "source": "Composition Sirenic : préparation e-facturation (INSEE Sirene), VIES (Commission européenne, live), contrôle de forme IBAN + registres bancaires officiels",
 "disclaimer": "Aide à la décision déterministe (raisons en liste fermée, tracées à leur source) — ni un avis de conformité fiscale, ni une Verification of Payee : le volet bancaire contrôle la FORME et identifie la banque, sans vérifier l'existence du compte ni le nom du titulaire ; la TVA (VIES) et l'état Sirene, eux, sont vérifiés en direct. / Deterministic decision support — neither tax-compliance advice nor a Verification of Payee: the bank leg checks FORM (structure + key digits) and identifies the bank, without checking the account's existence or the holder's name; the VAT (VIES) and the Sirene registry status are checked live."
}

Dated snapshot from 2026-08-07, truncated to one item per array. It is not live data. The full extract is served free of charge from the samples surface, and the schema from the OpenAPI document.

Full real response ↗

What the route returns

Catalogue description, exactly as agents read it:

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.

Price and billing

Price: $0.03. 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.

What this route does not do

This is not a payee verification: neither the holder's name nor the account's existence is checked. Sirenic is not an accredited e-invoicing platform and issues no invoices.

Neighbouring routes

/v1/facture/verifier: $0.02
/v1/tva/verifier/{numero}: $0.003
/v1/iban/verifier/{iban}: $0.005
/v1/eu/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 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 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

Routes used and pricing

Route	Price	Sample	What it returns
`/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.

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/facturation/dossier Get notified about euro packs

Supplier verification pack