GET/v1/entreprises/requete/lister
- Price
- $0.02
- 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 | -finances.ca |
page | query · optional | 1 |
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, or a counted total below the list read (compte_incoherent), never charged
See a real response (free) Get the quote for /v1/entreprises/requete/lister
What the route returns
Catalogue description, exactly as agents read it:
List French companies matching free cross-criteria on a pre-joined table of the official registries (the same criteria as the count route): geography, NAF activity, legal form, workforce, age, last filed accounts, public signals. Active legal persons by default. 100 companies per page, sorted on identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, with the exact total and the cut stated; each page is one payment.
Price and billing
Price: $0.02. 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
No e-mail address, no phone number, no officer: companies qualified by the official registries, never contact details. Active legal persons by default, ceased ones on an explicit criterion on identite.etat.
Neighbouring routes
/v1/entreprises/requete/compter: $0.002/v1/prospection: $0.02/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.
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/mcpRoutes used and pricing
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/entreprises/requete/lister | $0.02 | free sample | List French companies matching free cross-criteria on a pre-joined table of the official registries (the same criteria as the count route): geography, NAF activity, legal form, workforce, age, last filed accounts, public signals. Active legal persons by default. 100 companies per page, sorted on identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, with the exact total and the cut stated; each page is one payment. |
Frequently asked questions
Which fields can I sort on?
On identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, prefixed with - for descending order; missing values come last in both orders. Each sort orders the companies the criteria retain; the default sort, identite.siren ascending, only follows an index, the primary key, when a criterion is set on identite.siren. A broad query is narrowed first (beyond 15 s it is refused, never charged). 100 companies per page, 100 pages at most.
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/lister Get notified about euro packs