French company file (choose blocks)
get_french_company_fileRetrieve a French company's full registry file in one call by selecting only the data blocks you need, avoiding chained requests and paying per requested block.
Instructions
Full French company file in ONE call, paying only for the blocks you ask for: for when you need several things about the same company and do not want to chain calls. The identity base is $0.005; add any of etablissements, alertes_bodacc, contentieux, finances, marches_publics, marches_publics_ue, lobbying, risques_industriels, agrements, pi, documents, facturation_prep, score. Each block costs exactly what its dedicated endpoint costs, and the total is capped at $0.35. Any block that cannot be served is NAMED with a reason from a closed list: aucune_donnee (a negative answer, e.g. no patents), non_diffusible (GDPR/partial disclosure), non_couvert (not a proven legal person), panne_amont (upstream register down), stock_perime (local copy past its age limit), collecte_en_cours (local stock empty or never loaded) or identite_incomplete (incomplete identity). For a verdict rather than raw blocks, use get_french_company_intelligence ($1.00). An identity whose administrative status or legal category is missing in Sirene is served with blocs_absents (raison identite_incomplete) and a partial provenance. Blocks built on it (score, facturation_prep) are absent for that reason (identite_incomplete). If no requested block is served and one is down, stale (stock_perime) or with its local stock empty or never loaded (collecte_en_cours), the call returns 503 (a retry may serve a down block); else if one is refused for that reason, 404 identite_incomplete; neither is charged. Asking for score on a sole proprietorship, a restricted-diffusion unit or a group without legal personality refuses the whole file: 400 with the exact code, never charged. Partial diffusion (rule diffusion_partielle_nom_retenu_et_compte): for a unit not proven to be a legal person, identite.denomination and every documents nom_document are null, counted in ecartes.diffusion_partielle; facturation_prep.destinataire.denomination is null, uncounted, and destinataire.information states the partial diffusion. Public procurement block: Names are served for legal persons proven by their Sirene legal category only: a sole proprietorship, a group of natural persons or a category in doubt never has its name served and keeps its SIREN or SIRET, the omissions counted without identity in ecartes, over the entries the response serves (rule R1). A contract subject that names a person by a civility followed by a capital letter (M., Mme, Monsieur, Madame, Maître…) is served null, counted without identity in ecartes; the contract stays (rule R1). Paid via x402 in USDC or EURC. When you report a result, cite its citation verbatim.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"siren": "<siren>",
"blocs": "<blocs>"
},
"name": "get_french_company_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blocs | Yes | Comma-separated blocks, e.g. finances,pi,score. Available: etablissements, alertes_bodacc, contentieux, finances, marches_publics, marches_publics_ue, lobbying, risques_industriels, agrements, pi, documents, facturation_prep, score | |
| siren | Yes | 9-digit SIREN, e.g. 552032534 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |