sirenic

Alertes et surveillance

Créer une surveillance d'entreprises

La faille la plus commune d'un circuit d'onboarding est de contrôler à l'entrée puis de ne plus jamais revenir : une procédure collective s'ouvre après la signature. Cette route surveille aussi des cibles dirigeant, pas seulement des sociétés (utile quand le risque est la personne).

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

GET/v1/surveillance/creer

Prix
0,05 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entité
Quota gratuit
Non
Famille
Alertes et surveillance
Paramètres
ParamètreOùExemple
ciblesrequête · obligatoire552032534,542065479
dureerequête · facultatif30
webhookrequête · facultatifsans exemple
emailrequête · facultatifsans exemple
renouvellementrequê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 une réponse réelle (gratuit) Obtenir le devis de /v1/surveillance/creer

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

Surveillance pour la France : liste de suivi KYB et conformité de 30, 90 ou 365 jours (?duree=), contrôlée CHAQUE JOUR sur les sources officielles ; webhook signé, courriel, consultable. Entreprises (SIREN) : BODACC, état, dirigeants, sanctions/liste noire AMF, PSAN/SGP, Seveso, décisions des tribunaux de commerce, marchés FR et UE. Dirigeants (dirigeant:Nom, comptes identifiés seulement) : mandats nouveaux/terminés. Associations (RNA W…) : annonces JOAFE. Par cible (1-100) : 0,05 € / 0,135 € / 0,50 €. En x402 ou sur les crédits d'une clé, sans remboursement ; renouvellement=auto la renouvelle.

Identifiant attendu

Paramètre cibles : 1 à 100 cibles, chacune un SIREN, un numéro RNA d'association (W suivi de 9 caractères) ou une cible de la forme dirigeant:Nom (un nom seul, homonymes compris, réservée aux comptes identifiés : clé d'API). Plus duree=30|90|365.

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 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entité, 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.

Facturation par lot : le paramètre cibles accepte de 1 à 100 valeurs séparées par des virgules, et le montant est le prix unitaire multiplié par le nombre de valeurs. Le devis est figé avant règlement : il n'y a pas de règlement partiel.

Le prix unitaire dépend en outre du paramètre duree, en liste fermée : 0,05 € (30 j), 0,135 € (90 j), 0,50 € (365 j). Valeur par défaut : 30.

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

Paiement en x402 ou par les crédits d'une clé d'API, sans remboursement ni prorata. L'espace client (/compte/surveillances) liste, arrête et renouvelle sur les crédits du compte les veilles payées par une clé du compte, tout de suite ou automatiquement à chaque échéance (renouvellement=auto à la création par une clé) ; une veille payée en x402 s'y rattache par son jeton. Conservez le jeton rendu à la création : l'écran ne l'affiche jamais, et il permet d'interroger et de renouveler.

Routes voisines

  • /v1/surveillance/{jeton}/renouveler : 0,05 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entité
  • /v1/entreprise/{siren}/changements : 0,01 €

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 paie sur ses crédits : cette route n'entre pas au 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/surveillance/creer0,05 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entitéexemple gratuitSurveillance pour la France : liste de suivi KYB et conformité de 30, 90 ou 365 jours (?duree=), contrôlée CHAQUE JOUR sur les sources officielles ; webhook signé, courriel, consultable. Entreprises (SIREN) : BODACC, état, dirigeants, sanctions/liste noire AMF, PSAN/SGP, Seveso, décisions des tribunaux de commerce, marchés FR et UE. Dirigeants (dirigeant:Nom, comptes identifiés seulement) : mandats nouveaux/terminés. Associations (RNA W…) : annonces JOAFE. Par cible (1-100) : 0,05 € / 0,135 € / 0,50 €. En x402 ou sur les crédits d'une clé, sans remboursement ; renouvellement=auto la renouvelle.

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, paie ensuite sur ses crédits : cette route n'entre pas au quota gratuit.

Voir une réponse réelle (gratuit) Obtenir le devis de /v1/surveillance/creer Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur

À lire ensuite

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