Count companies by combined criteria

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

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

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/entreprises/requete/compter Get notified about euro packs

OpenAPI · llms.txt · Full route catalogue and pricing