Compléter et corriger un fichier clients en un appel

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

Identité en lot pour les fichiers clients et les bases CRM françaises : 2 à 300 lignes (SIREN, SIRET, numéro de TVA français ou nom|code postal), dans l'ordre du fichier. Par ligne : résolution (resolu, a_confirmer avec jusqu'à 5 candidats classés, introuvable, siren_invalide, siren_inconnu, non_diffusible), SIREN, SIRET du siège, état et date de cessation, adresse, numéro de TVA vérifié en direct au VIES (indisponible ou budget_vies_epuise, jamais un faux invalide), doublons. 0,003 € par ligne, 0,90 € au plus ; avec depuis (les changements depuis une date) 0,01 €, 3,00 € au plus.

Identifiant attendu

Paramètre lignes : de 2 à 300 lignes séparées par « ; », chacune un SIREN, un SIRET, un numéro de TVA français ou un couple nom|code postal. Avec depuis (un jour passé ou aujourd'hui), chaque ligne résolue porte aussi ses changements depuis cette date : le verdict, les totaux par type, les 3 derniers faits, la fenêtre réellement lue et lecture_complete.

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,003 € · 0,01 € (avec depuis) / 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 lignes accepte de 2 à 300 valeurs séparées par des points-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 de la présence du paramètre depuis : 0,003 € sans lui, 0,01 € avec lui (l'axe identite_et_changements), au même devis figé.

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 sur une ligne est dite sur cette ligne, servie et facturée : une TVA que le VIES n'a pas pu vérifier est indisponible, et, avec depuis, un BODACC qui n'a pas répondu est nommé dans ses changements. Le lot n'est refusé en 503, sans facturation, que si aucune ligne n'a pu lire le BODACC (avec depuis), si le stock Sirene ou l'index de recherche ne se lisent pas, si la base ne répond pas, ou si le service est saturé.

Ce que cette route ne fait pas

Ne crée ni ne vérifie aucune inscription à l'annuaire de la facturation électronique : la route prépare la base, elle n'émet rien. Un nom de personne physique n'est jamais résolu : un entrepreneur individuel n'est pas servi comme candidat, et sa ligne par SIREN revient sans nom ni adresse ni changements. La TVA est vérifiée en direct au VIES, ligne par ligne : aux heures ouvrées, le VIES sert un verdict toutes les 4 à 5 s et refuse la concurrence ; avant la vérification en pipeline, un lot plein n'a vérifié que 15 de ses 262 lignes résolues ; avec elle, hors heures ouvrées (23:51 UTC), 105 de ses 265 ; mesures du 08/10/2026. Une ligne dont la vérification n'a pu partir à temps le dit (non_verifie, budget_vies_epuise). Avec depuis, les marchés publics européens et la propriété industrielle ne sont pas lus (la route /v1/entreprise/{siren}/nouveautes les lit, une société à la fois), ni les dirigeants ; une panne du BODACC sur une ligne y est dite, et un lot dont aucune ligne n'a pu le lire est refusé sans facturation.

Routes voisines

• /v1/recherche — 0,002 €
• /v1/tva/verifier/{numero} — 0,003 €
• /v1/entreprise/{siren}/facturation-prep — 0,02 €

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

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 une réponse réelle (gratuit) Obtenir le devis de /v1/identite/lot Créer un compte : 150 appels gratuits par mois

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