GET/v1/entreprises/requete/compter
- Price
- $0.002
- Free quota
- Included
- Family
- France · identity, documents
| Parameter | Where | Example |
|---|---|---|
criteres | query · optional | [{"champ":"siege.departement","op":"=","valeur":"69"},{"champ":"finances.ca","op":">","valeur":1000000}] |
tri | query · optional | no example |
page | query · optional | no example |
champs | query · optional | no example |
What is charged
200Ed25519-signed response, charged at the route's price402Signed x402 quote, nothing is debited4xxUnknown or invalid identifier, never charged5xxUpstream source unavailable, never charged
See a response on test data (free) Get the quote for /v1/entreprises/requete/compter
What the route returns
Catalogue description, exactly as agents read it:
Count French companies matching free cross-criteria on a pre-joined table of the official registries: geography (departement, region, postal-code prefix), NAF activity, legal form, workforce, age, last filed accounts (revenue, net income, margins, ratios, trends, cash items) and public signals (RGE, equality index, ICPE/Seveso, public contracts, authorisations). Active legal persons by default. Returns the exact count and each source's date: size a market before listing it.
Price and billing
Price: $0.002. 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
Active legal persons by default (a criterion on identite.etat also counts ceased companies), no officer and no person as a criterion: sole traders are never counted. A financial criterion only retains companies that file usable accounts.
Neighbouring routes
/v1/entreprises/requete/lister: $0.02/v1/prospection: $0.02/v1/secteur/{code_naf}/benchmarks: $0.05
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. 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/entreprises/requete/compter | $0.002 | free sample | Count French companies matching free cross-criteria on a pre-joined table of the official registries: geography (departement, region, postal-code prefix), NAF activity, legal form, workforce, age, last filed accounts (revenue, net income, margins, ratios, trends, cash items) and public signals (RGE, equality index, ICPE/Seveso, public contracts, authorisations). Active legal persons by default. Returns the exact count and each source's date: size a market before listing it. |
Frequently asked questions
Which fields can I combine?
The catalogue's filterable fields: identite.siren, identite.personne_morale, identite.forme, identite.naf, identite.categorie_entreprise, identite.tranche_effectifs, identite.date_creation, identite.age, identite.etat, identite.ess, identite.societe_mission, siege.code_postal, siege.code_commune, siege.departement, siege.region, finances.date_cloture, finances.type_bilan, finances.fiabilite, finances.nb_exercices, finances.ca, finances.marge_brute, finances.ebe, finances.ebit, finances.resultat_net, finances.taux_endettement, finances.autonomie_financiere, finances.ratio_liquidite, finances.caf_sur_ca, finances.capacite_remboursement, finances.marge_ebe, finances.rcai_sur_ca, finances.couverture_interets, finances.bfr_sur_ca, tendances.variation_ca_1an, tendances.variation_ca_3ans, tendances.variation_rn_1an, tendances.variation_bfr_sur_ca_3ans, tendances.trajectoire, tresorerie.disponibilites, tresorerie.dettes_moins_1an, tresorerie.dettes_fiscales_sociales, tresorerie.dettes_total, signaux.rge_actif, signaux.egapro_note, signaux.egapro_annee, signaux.icpe_nb, signaux.icpe_seveso, signaux.marches_nb, signaux.marches_montant, signaux.marches_dernier, signaux.etablissements_ouverts_24_mois, signaux.etablissements_fermes_24_mois, signaux.marches_12_mois, signaux.marches_12_mois_precedents, signaux.agrements. Up to 20 conditions combined with AND; OR goes through the in operator. GET /v1/lecture (free) gives each one's type, operators, unit, source and meaning.
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.
See a response on test data (free) Get the quote for /v1/entreprises/requete/compter Create an account: 150 free calls a month up to EUR 2 of value