Batch default-risk score, by basket

What the route returns

Catalogue description, exactly as agents read it:

Batch credit risk scoring of 2 to 100 French companies (comma-separated sirens): each line has the score, class and model version of GET /v1/score/defaillance/{siren} and a closed-list basket (expose, a_surveiller, sain, non_evaluable with its cause, cessee). Rank my customers by risk and monitor the 30 most exposed: chainage.surveillance lists the whole ranked expose basket (100 at most) with its 30-day quote, targets x unit price; keep the first 30. $0.07 per SIREN, unknown SIREN included.

Expected identifier

sirens parameter: 2 to 100 company numbers, comma-separated.

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.07 / entity. 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.

Batch billing: the sirens parameter accepts 2 to 100 comma-separated values, and the amount is the unit price times the number of values. The quote is frozen before settlement: there is no partial settlement.

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

On an arbitrary file of legal entities, most lines are not assessable for lack of published accounts (measured on 2026-10-03: 86% of active legal entities, 71.5% of commercial companies); they are billed with their cause. The proposed watch is daily, never real time.

Neighbouring routes

• /v1/score/defaillance/{siren}: $0.10
• /v1/surveillance/creer: $0.05 (30 days) · $0.135 (90 days) · $0.50 (365 days) / entity
• /v1/kyb/batch: $0.105 / entity

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.

Open today: 150 free calls a month with an account, on 106 of 122 routes (the price list says which), and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

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

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes used and pricing

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 response on test data (free) Get the quote for /v1/score/defaillance/lot Create an account: 150 free calls a month

Read next

• Assessing a customer's default risk

OpenAPI · llms.txt · Full route catalogue and pricing