Comparing companies on official data
Comparing companies is the easiest way to produce a wrong but convincing figure. Two companies in the same sector, one reporting statutory accounts and the other consolidated, are not comparable, and a well-formatted table makes you forget it. /v1/comparer returns per-axis rankings and a comparability block that tells you when to stop.
See a real response (free) Get the quote for /v1/comparer
Never an overall winner, deliberately
An overall rating implies a weighting between revenue, profitability, structure and risk. That weighting depends on your decision: shortlisting a supplier is not the same trade-off as granting payment terms. So we return a ranking per axis and let you weight, rather than hiding a trade-off inside a single number.
The six guards against a false comparison
- Revenue at 0 is treated as missing, not as zero.
- The accounting scope is declared: statutory or consolidated, and series where the source conflates the two are flagged.
- A no-conclusion score stays no-conclusion: it is not replaced by a median value to fill the table.
- Financial years with different end dates are flagged: comparing a 2024 year with a 2022 year is not a comparison.
- The presence of a holding company in the batch is flagged: its accounts do not read like an operating company's.
- Sanctions screening is returned as a per-company boolean, with no ranking: you do not “rank” companies on a sanctions list.
The quote is signed and priced per company: the amount is the unit price times the number of company numbers passed, known before settlement.
Placing a company against its sector
Comparing two companies with each other does not tell you whether either is normal. /v1/secteur/{code_naf}/benchmarks returns, for an activity code at any level, the number of active companies, the median age with quartiles, the workforce-bracket distribution and, as soon as at least 5 companies file public accounts, median revenue, margin, result and debt ratio. 1,692 sectors are covered.
Aggregates only, no personal data, and sectors with fewer than 5 companies are excluded: an aggregate over three companies re-identifies its members.
How you pay
Every route is paid per call, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota; /v1/comparer is not in it and is paid on its credits. Over x402, 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, up to EUR 2 of value, on 122 of 129 routes (the price list says which), with 100 more free lines a month on batch identity, 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
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/comparer | $0.12 / entity | free sample | Company comparison: compare 2 to 5 French companies side by side in one call on official data: identity, deterministic default-risk score, last filed accounts and BODACC insolvency alerts. Benchmarking for supplier selection: per-axis rankings, never an overall winner, and a comparabilite block that flags NOT comparable companies. Billed PER COMPANY: signed quote = $0.12 x SIREN count. Fully disclosed legal persons only: a sole proprietor or restricted unit refuses the batch (400, not charged). |
/v1/secteur/{code_naf}/benchmarks | $0.05 | free sample | Sector benchmarks and sector statistics for a French NAF activity code (any level: division, groupe, classe, sous-classe): number of active companies, median company age (with quartiles), workforce-bracket distribution, and, when at least 5 companies file public accounts, median revenue, EBITDA margin, pre-tax result and debt ratio. Peer comparison in one call: place a company against its peers. Aggregates only, no personal data; sectors with fewer than 5 companies are excluded. |
/v1/entreprise/{siren}/finances | $0.01 | free sample | Financials of a French company (annual accounts filed at INPI, Banque de France ratios): revenue, EBITDA, net income, debt, financial autonomy, ONE row per fiscal year, each graded (qualite: exploitable / a_verifier / non_exploitable, anomalies, doubtful fields); source rows set aside are served in exercices_ecartes with their reason. Consolidated accounts are served apart and graded the same way. Includes INPI-keyed tax-form line items (up to 20 balance sheets) and a perimetre_comptable block. |
Frequently asked questions
How many companies at most?
Five. Beyond that, a comparison table stops being useful; better to run the KYB batch and then compare the axes you care about.
What if the comparability block says “not comparable”?
Read it as an answer, not an error. It tells you the table you were about to show would have been misleading. The useful next step is usually to compare each against its own sector rather than against the other.
Take it further
The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota; /v1/comparer is not in it and is paid on its credits.
See a real response (free) Get the quote for /v1/comparer Read the route reference Create an account: 150 free calls a month up to EUR 2 of value
Read next
Volume figures on this page were measured in our database on 2026-10-18. They are dated snapshots, not live counters. · OpenAPI · llms.txt · Full route catalogue and pricing