sirenic

France · identité, documents

Lister les entreprises par critères croisés

La liste suit le compte : les mêmes critères, triés sur identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca. Chaque page est un paiement et dit le total exact, compté dans la même transaction que la page : on sait ce qu'il reste avant de payer la suivante.

https://api.sirenic.eu/v1OpenAPI 3.1llms.txt

GET/v1/entreprises/requete/lister

Prix
0,02 €
Quota gratuit
Inclus
Famille
France · identité, documents
Paramètres
ParamètreOùExemple
criteresrequête · facultatif[{"champ":"siege.departement","op":"=","valeur":"69"},{"champ":"finances.ca","op":">","valeur":1000000}]
trirequête · facultatif-finances.ca
pagerequête · facultatif1
champsrequête · facultatifsans exemple

Ce qui est facturé

  • 200Réponse signée Ed25519, débitée au prix de la route
  • 402Devis x402 signé, rien n'est débité
  • 4xxIdentifiant inconnu ou invalide, jamais facturé
  • 5xxSource amont indisponible, ou total compté sous la liste lue (compte_incoherent), jamais facturé

Voir une réponse sur données de test (gratuit) Obtenir le devis de /v1/entreprises/requete/lister

Ce que la route rend

Description publiée au catalogue, traduite ici en français (les agents la lisent en anglais, comme toutes nos surfaces de découverte) :

Listez les entreprises françaises qui répondent à des critères croisés librement sur une table pré-croisée des registres officiels (les mêmes critères que la route de comptage) : géographie, activité NAF, forme juridique, effectif, ancienneté, derniers comptes déposés, signaux publics. Personnes morales actives par défaut. 100 entreprises par page, triées sur identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, avec le total exact et la coupe dits ; chaque page est un paiement.

Prix et facturation

Tarif : 0,02 €, débité en crédits (1 crédit = 1 €) ; en x402, le même montant se règle en USDC ou en EURC. Le montant qui fait foi est celui du devis 402 renvoyé par la route elle-même, pas ce texte, qui est dérivé de la même grille mais reste une page.

Une réponse d'erreur annule le paiement : un 400, un 404 ou un 503 n'est jamais facturé. Une panne d'une source amont ferme la route en 503 plutôt que de servir une réponse dégradée.

Ce que cette route ne fait pas

Aucune adresse électronique, aucun téléphone, aucun dirigeant : des sociétés qualifiées par les registres officiels, jamais des coordonnées. Personnes morales actives par défaut, les cessées sur un critère explicite sur identite.etat.

Routes voisines

  • /v1/entreprises/requete/compter : 0,002 €
  • /v1/prospection : 0,02 €
  • /v1/kyb/batch : 0,105 € / entité

Comment on paie

Chaque route se paie à l'appel, de deux façons, sans abonnement : en x402, en USDC ou EURC sur le réseau Base, sans compte ni clé d'API ; ou avec la clé d'API d'un compte, qui ouvre le quota gratuit. En x402, le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, dans la limite de 2 € de valeur, sur 122 routes sur 129 (la grille dit lesquelles), plus 100 lignes gratuites par mois sur l'identité en lot, et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.

Les réponses payantes sont signées Ed25519 : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans l'OpenAPI et le llms.txt.

Un appel, de bout en bout

# Client x402 (npm) : le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes utilisées et prix

RoutePrixExempleCe qu'elle rend
/v1/entreprises/requete/lister0,02 €exemple gratuitListez les entreprises françaises qui répondent à des critères croisés librement sur une table pré-croisée des registres officiels (les mêmes critères que la route de comptage) : géographie, activité NAF, forme juridique, effectif, ancienneté, derniers comptes déposés, signaux publics. Personnes morales actives par défaut. 100 entreprises par page, triées sur identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, avec le total exact et la coupe dits ; chaque page est un paiement.

Questions fréquentes

Sur quels champs puis-je trier ?

Sur identite.siren, finances.date_cloture, finances.ca, finances.resultat_net, finances.bfr_sur_ca, préfixés de - pour l'ordre décroissant ; les valeurs absentes viennent en dernier dans les deux ordres. Chaque tri ordonne les sociétés que les critères retiennent ; le tri par défaut, identite.siren croissant, ne suit un index, la clé primaire, que quand un critère en =, in ou prefixe porte sur identite.siren. Une requête large se resserre d'abord (au-delà de 15 s, elle est refusée sans être facturée). 100 entreprises par page, 100 pages au plus.

Passer à l'action

La première étape est gratuite et vous montre exactement ce que vous achèteriez, sans compte ni clé ; un compte, avec sa clé d'API, ouvre ensuite le quota gratuit.

Voir une réponse sur données de test (gratuit) Obtenir le devis de /v1/entreprises/requete/lister Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur

OpenAPI · llms.txt · Catalogue complet des routes et prix