Surveiller un portefeuille de clients ou de fournisseurs
Contrôler un client à l'entrée puis ne plus jamais y revenir est la faille la plus commune d'un circuit d'onboarding. Une procédure collective s'ouvre après la signature, pas avant. /v1/surveillance/creer pose une veille sur 1 à 100 cibles, contrôlées chaque jour contre les sources officielles.
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/surveillance/creer
Ce qui est surveillé
Sur une cible entreprise (SIREN)
Annonces au registre officiel des annonces légales, changement de statut, mouvements de dirigeants, criblage sanctions et liste noire de l'autorité des marchés, agréments de prestataires de services sur actifs numériques et de sociétés de gestion, classement Seveso, et nouvelles attributions de marchés publics français et européens.
Sur une cible dirigeant
Prises et fins de mandats, sous un nom seul : la veille suit aussi ses homonymes, et elle est réservée aux comptes identifiés (clé d'API), comme les actes. Utile quand le risque n'est pas la société mais la personne qui la dirige : un dirigeant qui multiplie les mandats dans des sociétés en difficulté est un signal que le seul suivi de l'entreprise ne donne pas.
Sur une cible association (numéro RNA)
Chaque nouvelle annonce publiée au Journal officiel des associations (JOAFE) sous ce numéro RNA, quel qu'en soit le type, signalée avec son identifiant, son type et sa date de parution. La cible s'écrit comme le numéro lui-même, W suivi de 9 caractères, dans la même liste que les SIREN et les dirigeants ; un identifiant hérité, sans W, n'a aucune annonce au JOAFE et n'est pas accepté. Le premier passage enregistre les annonces déjà publiées sans les signaler, et un JOAFE périmé est noté comme une source en panne, jamais lu comme « rien à signaler ».
Trois durées, un prix par cible et par durée
La durée se choisit à la création (paramètre ?duree=) : 30, 90 ou 365 jours. Le devis est coté sur deux axes (nombre de cibles × durée) et figé avant règlement. Les trois tarifs unitaires figurent dans le tableau des routes ci-dessous ; ils ne sont pas recopiés dans ce texte, précisément pour qu'ils ne puissent pas y devenir faux.
Le renouvellement (/v1/surveillance/{jeton}/renouveler) accepte n'importe quelle durée, quelle que soit celle d'origine, et reste possible jusqu'à 7 jours après l'expiration ; au-delà, la veille est purgée. Le paramètre cibles doit répéter exactement les cibles surveillées : c'est de là que le devis est calculé.
Elle se paie en x402 ou par les crédits d'une clé d'API, sans remboursement ni prorata. L'espace client (onglet Surveillances, /compte/surveillances) liste les veilles payées par une clé du compte, les arrête et les renouvelle sur les crédits du compte, tout de suite ou automatiquement à chaque échéance (renouvellement=auto à la création par une clé, ou l'interrupteur de l'écran ; jamais plus que le montant affiché) ; 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 c'est lui qui permet d'interroger et de renouveler la veille par l'API.
Trois façons d'être prévenu
- Webhook signé Ed25519 : vous vérifiez la signature avec notre clé publique et savez que l'alerte vient bien de nous, sans secret partagé à faire tourner.
- Résumé par e-mail, pour un usage humain.
- Tirage : la veille reste interrogeable à tout moment avec son jeton, ce qui évite d'avoir à exposer un point d'entrée public pour recevoir un webhook.
Surveiller, ou interroger de temps en temps ?
Si votre portefeuille est petit et votre rythme mensuel, /v1/entreprise/{siren}/changements?depuis=AAAA-MM-JJ suffit : il rend les annonces publiées depuis une date, et vous ne payez que quand vous demandez. La veille se justifie dès que le délai de détection compte, parce qu'elle contrôle chaque jour, y compris les jours où vous ne pensez pas à demander.
La route de changements détecte les nouvelles publications au registre des annonces légales, pas les modifications champ par champ d'une fiche : le stock d'identité est une photo mensuelle et ne conserve pas d'historique. Ne l'attendez pas sur un changement d'adresse silencieux.
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 ; /v1/surveillance/creer et /v1/surveillance/{jeton}/renouveler n'y entrent pas et se paient sur ses crédits. 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
| Route | Prix | Exemple | Ce qu'elle rend |
|---|---|---|---|
/v1/surveillance/creer | 0,05 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entité | exemple gratuit | 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. |
/v1/surveillance/{jeton}/renouveler | 0,05 € (30 j) · 0,135 € (90 j) · 0,50 € (365 j) / entité | exemple gratuit | Renouvellement de liste de suivi : prolongez une surveillance d'entreprises (SIREN), de dirigeants (dirigeant:Nom, comptes identifiés seulement) et/ou d'associations (RNA) de 30, 90 ou 365 jours (?duree=, 30 par défaut, toute durée d'origine) de contrôle quotidien sur les sources officielles : 0,05 € / 0,135 € / 0,50 € par cible. Le paramètre cibles répète exactement les cibles surveillées (il fixe le devis). Possible jusqu'à 7 jours après l'expiration, puis purgée. Sans remboursement ni prorata. Renouvellement automatique : renouvellement=auto à la création par une clé, ou dans l'espace client. |
/v1/entreprise/{siren}/changements | 0,01 € | exemple gratuit | Surveillance des changements d'une entreprise française : les nouvelles annonces officielles du BODACC publiées DEPUIS une date donnée (?depuis=YYYY-MM-DD) : la route d'interrogation pour la surveillance d'une liste de suivi ou d'un portefeuille. Renvoie les nouvelles annonces (procédure collective, radiation, ventes, dépôts, modifications) de la plus récente à la plus ancienne. À noter : détecte les nouvelles publications BODACC, pas les modifications champ par champ de la fiche Sirene/RNE (le stock mensuel ne conserve aucun historique). |
/v1/entreprise/{siren}/alertes | 0,01 € | exemple gratuit | Alertes légales d'une entreprise française issues du BODACC, le journal officiel français des annonces légales : procédures collectives et décisions de justice associées, radiations et ventes de fonds, regroupées et les plus récentes d'abord. Vérifiez si une entreprise française fait l'objet d'une procédure collective avant de contracter : un signal de due diligence, de KYB et de conformité pour l'entrée en relation fournisseur et la surveillance du risque, tiré des données officielles du registre. |
Questions fréquentes
Comment vérifier la signature du webhook ?
Avec notre clé publique Ed25519, publiée sur le site. La vérification tient en quelques lignes dans n'importe quel langage, et un exemple est fourni dans notre dépôt d'exemples.
Puis-je surveiller un dirigeant par son nom ?
Oui, avec une cible de la forme dirigeant:Nom et la clé d'API d'un compte : la cible dirigeant est réservée aux comptes identifiés, comme les actes, et sans compte elle est refusée avant tout devis. C'est un nom seul, qui suit aussi ses homonymes sans les distinguer. La veille ne rend que des prises et fins de mandats issues des publications officielles : pas de données personnelles au-delà de ce que le registre publie. Le nom passé figure en clair, avec la requête de création, dans le journal de notre serveur frontal, gardé 7 jours au plus, jusqu'à ce que le filtre qui l'en retire soit posé.
Que se passe-t-il si une source officielle est en panne un jour ?
Le passage est reporté, pas effacé. C'est une règle de conception : une liste indisponible ne doit jamais produire un silence qui se lise comme « rien à signaler ». Un passage réussi mais vide ne peut pas non plus rajeunir la photo : un tel désarmement a déjà été identifié et fermé.
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 ; /v1/surveillance/creer et /v1/surveillance/{jeton}/renouveler n'y entrent pas et se paient sur ses crédits.
Voir une réponse réelle (gratuit) Obtenir le devis de /v1/surveillance/creer Lire la référence de la route Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur