sirenic

France · finances and risk

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.

https://api.sirenic.eu/v1OpenAPI 3.1llms.txt

GET/v1/entreprise/{siren}/sante

Price
$0.15
Free quota
No
Family
France · finances and risk
Parameters
ParameterWhereExample
sirenpath · required552032534

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/entreprise/{siren}/sante

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 in the path 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. A search parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

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.

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 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

RoutePriceSampleWhat it returns
/v1/entreprise/{siren}/sante$0.15free sampleCompany 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

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/entreprise/{siren}/sante Get notified about euro packs

Read next

OpenAPI · llms.txt · Full route catalogue and pricing