# Compléter et corriger un fichier clients en un appel

C'est la route du nettoyage de masse, avant la première facture électronique ou une campagne. Ce qui la distingue : elle ne choisit jamais à votre place. Un nom n'est résolu que si un seul candidat existe à ce code postal, toutes étapes de l'index lues, et qu'il porte ce nom (sa dénomination, sa dénomination usuelle ou son sigle) ; sinon la ligne revient a_confirmer avec ses candidats classés, ou introuvable. Chaque ligne garde son rang dans votre fichier, les doublons sont signalés, et le nom saisi n'est jamais recopié.

## 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.

## Extrait d'une réponse réellement payée

Photo datée du 08/10/2026, tronquée à un élément par tableau. Ce n'est pas une donnée en direct. L'extrait complet est servi **gratuitement** par [la surface d'exemples](https://api.sirenic.eu/exemples/identite-lot.json), et le schéma par l'OpenAPI.

```
{
 "nombre_lignes": 2,
 "comptes": {
  "resolution": {
   "resolu": 1,
   "a_confirmer": 1,
   "introuvable": 0,
   "siren_invalide": 0,
   "siren_inconnu": 0,
   "non_diffusible": 0
  },
  "etat": {
   "actif": 1,
   "cesse": 0
  },
  "tva_vies": {
   "valide": 1,
   "invalide": 0,
   "indisponible": 0,
   "non_verifie": 0
  },
  "doublons": 0,
  "lignes_a_etages_abandonnes": 0
 },
 "lignes": [
  {
   "rang": 1,
   "identifiant_lu": "siren",
   "resolution": "resolu",
   "siren": "552032534",
   "siret_siege": "55203253400703",
   "denomination": "DANONE",
   "etat": "actif",
   "adresse": "59 RUE LA FAYETTE 75009 PARIS",
   "tva": {
    "numero": "FR27552032534",
    "vies": "valide"
   }
  },
  {
   "rang": 2,
   "identifiant_lu": "nom_cp",
   "resolution": "a_confirmer",
   "candidats": [
    {
     "siren": "352476329",
     "denomination": "HERMES INTERNATIONAL",
     "etat": "cesse",
     "score_confiance": 1
    },
    {
     "siren": "572076396",
     "denomination": "HERMES INTERNATIONAL",
     "etat": "actif",
     "score_confiance": 1
    },
    {
     "siren": "377788997",
     "denomination": "HERMES CONSULTANTS INTERNATIONAL ASSOCIE",
     "etat": "cesse",
     "score_confiance": 0.98
    }
   ],
   "candidats_non_servis": {},
   "listes_bornees": {
    "candidats": {
     "nombre_total": 3,
     "tronque": false
    }
   }
  }
 ]
}
```

## 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é.

## Appeler la route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i "https://api.sirenic.eu/v1/identite/lot?lignes=552032534%3BHERMES%20INTERNATIONAL%7C75008"

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch "https://api.sirenic.eu/v1/identite/lot?lignes=552032534%3BHERMES%20INTERNATIONAL%7C75008"

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
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
```

## 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](https://api.sirenic.eu/openapi.json) et le [llms.txt](https://api.sirenic.eu/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/identite/lot` | 0,003 € · 0,01 € (avec depuis) / entité | [exemple gratuit](https://api.sirenic.eu/exemples/identite-lot.json) | 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. |

## Passer à l'action

- [Voir une réponse réelle (gratuit)](https://api.sirenic.eu/exemples/identite-lot.json)
- [Obtenir le devis de /v1/identite/lot](https://api.sirenic.eu/v1/identite/lot?lignes=552032534%3BHERMES%20INTERNATIONAL%7C75008)
- [Créer un compte : 150 appels gratuits par mois](https://api.sirenic.eu/compte?utm_source=recherche&utm_campaign=referencement)


---

[Accueil](https://api.sirenic.eu/) · [Offres](https://api.sirenic.eu/offres) · [Articles](https://api.sirenic.eu/articles) · [Routes](https://api.sirenic.eu/api) · [À propos](https://api.sirenic.eu/a-propos) · [Mentions légales](https://api.sirenic.eu/mentions-legales) · [Confidentialité](https://api.sirenic.eu/confidentialite)