# À-la-carte company dossier

The answer to the classic complaint about narrow APIs: “I have to call five routes”. Here you pick the blocks and pay for those only. It is the middle ground between one very rich but costly record and a set of calls to orchestrate.

## What the route returns

Catalogue description, exactly as agents read it:

**Full French company file in ONE call: identity is the base, then add the blocks you want and pay only for those — etablissements, alertes_bodacc, finances, marches_publics, marches_publics_ue, lobbying, risques_industriels, agrements, pi, documents, facturation_prep, score. Example: blocs=finances,pi,score on siren 552032534. Each block costs what its own endpoint costs, total capped at $0.35. A block that cannot be served is NAMED with its reason: no data, not disclosable, or upstream outage.**

## Expected identifier

9-digit company number, plus the list of requested blocks.

> ⚠️ A wrongly formatted identifier returns `400` and is **not billed** — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes.

## Extract from a genuinely paid response

Dated snapshot from 2026-08-11, truncated to one item per array. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "siren": "552032534",
 "identite": {
  "siren": "552032534",
  "denomination": "DANONE",
  "nature_juridique": "5599",
  "activite_principale": "70.10Z",
  "categorie_entreprise": "GE",
  "etat_administratif": "actif"
 },
 "blocs_demandes": [
  "finances",
  "pi",
  "score"
 ],
 "blocs": {
  "finances": {
   "siren": "552032534",
   "nombre_exercices": 8,
   "exercices": [
    {
     "date_cloture": "2024-12-31",
     "chiffre_affaires": 1030000000,
     "ebe": 697000000,
     "resultat_net": 592000000
    }
   ]
  },
  "pi": {
   "marques": {
    "nombre": 88,
    "liste": [
     {
      "numero": "4789796",
      "libelle": "THE ONE HOME",
      "statut": "Marque enregistrée"
     }
    ]
   },
   "brevets": {
    "nombre": 12
   },
   "modeles": {
    "nombre": 3
   }
  },
  "score": {
   "siren": "552032534",
   "score_risque": 22,
   "classe": "sain",
   "risque_12m": "faible",
   "confiance": "moyenne",
   "version_modele": "defaillance-v1.8"
  }
 },
 "blocs_absents": [],
 "resume": {
  "demandes": 3,
  "servis": 3,
  "absents": 0,
  "dont_panne_amont": 0
 }
}
```

## Price and billing

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

## Calling the route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/entreprise/552032534/dossier

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534/dossier

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Neighbouring routes

- `/v1/kyb/{siren}` — $0.15
- `/v1/entreprise/{siren}` — $0.005
- `/v1/intelligence/{siren}` — $1.00

## 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](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) 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](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
```

## Routes used and pricing

| Route | Price | What it returns |
| --- | --- | --- |
| `/v1/entreprise/{siren}/dossier` | $0.005 | Full French company file in ONE call: identity is the base, then add the blocks you want and pay only for those — etablissements, alertes_bodacc, finances, marches_publics, marches_publics_ue, lobbying, risques_industriels, agrements, pi, documents, facturation_prep, score. Example: blocs=finances,pi,score on siren 552032534. Each block costs what its own endpoint costs, total capped at $0.35. A block that cannot be served is NAMED with its reason: no data, not disclosable, or upstream outage. |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/entreprise-siren-dossier.json)
- [Get the quote for /v1/entreprise/{siren}/dossier](https://api.sirenic.eu/v1/entreprise/552032534/dossier)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)

---

Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

Full catalogue : https://api.sirenic.eu/