# Written risk read-out of a company

The written counterpart to the score: what you put in front of someone who has to decide. The internal rule is strict and worth knowing — a model ticks a closed-list grid, the code writes the sentences, and deterministic guards overrule it when the accounts disagree.

## What the route returns

Catalogue description, exactly as agents read it:

**Company health check for a French company: a bilingual risk read-out — verdict, strengths, warning signs, activity trend and confidence level — from official data only (identity, BODACC alerts, filed financials, sanctions screening). A model fills a closed evaluation grid; every figure, date and sentence is assembled by Sirenic, and guards overrule it when the accounts disagree. Entities filing no accounts get an explicit no-conclusion verdict. For KYB and due diligence. Cached 7 days.**

## Expected identifier

9-digit company number.

> ⚠️ 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-10, 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",
 "synthese": {
  "points_forts": [
   "Résultats nets positifs récurrents"
  ],
  "points_vigilance": [
   "Ratios incohérents dans la source officielle"
  ],
  "donnees_manquantes": [
   "Structure du passif"
  ],
  "verdict": "sous_reserve",
  "tendance_activite": "croissance",
  "niveau_confiance": "faible"
 },
 "grille": {
  "verdict": "sous_reserve",
  "ca_tendance": "croissance_forte",
  "ca_regularite": "irreguliere",
  "rentabilite_niveau": "forte",
  "rentabilite_tendance": "volatile",
  "endettement_niveau": "eleve",
  "endettement_tendance": "alourdissement",
  "autonomie_financiere": "correcte",
  "liquidite": "echelle_non_etablie",
  "capacite_remboursement": "correcte",
  "bfr_exploitation": "atypique_negatif",
  "structure_synthese": "equilibree",
  "points_forts": [
   "resultats_nets_positifs_recurrents"
  ],
  "points_vigilance": [
   "ratios_incoherents"
  ],
  "confiance_niveau": "faible",
  "confiance_motifs": [
   "incoherences_detectees"
  ],
  "donnees_manquantes": [
   "structure_du_passif"
  ]
 },
 "divergences_modele": [
  "correspondance de criblage : verdict contraste -> sous_reserve"
 ],
 "modele": "claude-sonnet-5",
 "version_prompt": "sante-v2",
 "genere_le": "2026-08-11T07:51:02.474Z",
 "donnees": {
  "score_completude": 100,
  "data_freshness": "identité : stock Sirene mensuel (2026-07-01)"
 },
 "depuis_cache": true
}
```

## Price and billing

Price: **$0.15**. 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/sante

# 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/sante

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

## What this route does not do

Response cached for 7 days. No free-form model text is served: every figure, date and sentence is assembled by us.

## Neighbouring routes

- `/v1/score/defaillance/{siren}` — $0.10
- `/v1/rapport/{siren}` — $0.50

## 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}/sante` | $0.15 | Company health check for a French company: a bilingual risk read-out — verdict, strengths, warning signs, activity trend and confidence level — from official data only (identity, BODACC alerts, filed financials, sanctions screening). A model fills a closed evaluation grid; every figure, date and sentence is assembled by Sirenic, and guards overrule it when the accounts disagree. Entities filing no accounts get an explicit no-conclusion verdict. For KYB and due diligence. Cached 7 days. |

> ⚠️ 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.

## Take it further

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

## Read next

- [Assessing a customer's default risk](https://api.sirenic.eu/en/use-cases/assess-customer-s-default-risk-with-scorecard-returned)

---

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/