sirenic

France · identité, documents

Briefing d'une entreprise française pour une IA

Un texte court, écrit par le code, à coller dans une IA : la consigne de s'en tenir aux données lues, l'état de chaque bloc, et la ligne de source à recopier. Le JSON se demande par Accept: application/json.

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

GET/v1/entreprise/{siren}/briefing

Prix
0,05 €
Quota gratuit
Inclus
Famille
France · identité, documents
Paramètres
ParamètreOùExemple
sirenchemin · obligatoire552032534
languerequê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, jamais facturé

Voir l'exemple reconstitué (gratuit) Obtenir le devis de /v1/entreprise/{siren}/briefing

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) :

Briefing prêt pour une IA sur une entreprise française par SIREN, en Markdown par défaut (JSON par Accept: application/json), en français ou en anglais (langue=fr|en) : identité sans dirigeants, comptes déposés sur trois exercices et leur fiabilité, procédures collectives BODACC, décisions des tribunaux de commerce et marchés publics comptés et datés, chaque bloc avec son état, son âge et sa couverture, une ligne de source à citer. Écrit par le code, sans modèle. Personnes morales seulement.

Identifiant attendu

SIREN à 9 chiffres d'une personne morale en diffusion totale ; un entrepreneur individuel ou une diffusion partielle répond 400, jamais facturé. Paramètre langue : fr ou en.

Un identifiant au mauvais format dans le chemin rend 400 et n'est pas facturé — mais il vous fait perdre un aller-retour. C'est la première cause d'appel raté sur les routes étrangères. Un paramètre de recherche, lui, est nettoyé : les caractères non pris en charge sont retirés et la requête utile est servie.

Prix et facturation

Tarif : 0,05 €, 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 personne physique, ni verdict ni score : ceux-ci restent vendus par /v1/intelligence/{siren} et /v1/score/defaillance/{siren}.

Routes voisines

  • /v1/entreprise/{siren} — 0,005 €
  • /v1/entreprise/{siren}/finances — 0,01 €
  • /v1/entreprise/{siren}/dossier — 0,005 €

Comment on paie

Chaque route se paie à l'appel, en USDC ou EURC sur le réseau Base, par le protocole x402 : pas de compte à créer, pas de clé d'API, pas d'abonnement. 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, sur 106 routes sur 122 (la grille dit lesquelles), 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/entreprise/{siren}/briefing0,05 €exemple gratuitBriefing prêt pour une IA sur une entreprise française par SIREN, en Markdown par défaut (JSON par Accept: application/json), en français ou en anglais (langue=fr|en) : identité sans dirigeants, comptes déposés sur trois exercices et leur fiabilité, procédures collectives BODACC, décisions des tribunaux de commerce et marchés publics comptés et datés, chaque bloc avec son état, son âge et sa couverture, une ligne de source à citer. Écrit par le code, sans modèle. Personnes morales seulement.

Passer à l'action

Aucun compte à créer, aucune clé à demander : la première étape est gratuite et vous montre exactement ce que vous achèteriez.

Voir l'exemple reconstitué (gratuit) Obtenir le devis de /v1/entreprise/{siren}/briefing Créer un compte : 150 appels gratuits par mois

À lire ensuite

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