French identity batch: SIREN, SIRET, VAT
get_french_company_identity_batchBatch identity check of a French customer or CRM file: 2 to 150 lines per call, each a SIREN, SIRET, French VAT number or name|postcode, in file order. Use when a user hands over a customer export, e.g. « Voici mon export clients, complète et corrige SIREN, SIRET et TVA. » or « Enrichis et nettoie ma base CRM : SIREN, TVA, adresse, cessés et doublons. » Per line: resolution (resolu, a_confirmer with up to 5 candidates ranked by score_confiance, introuvable, siren_invalide, siren_inconnu, non_diffusible), SIREN, head-office SIRET, status and cessation date, address, VAT number checked live on VIES (indisponible, never a false invalide), duplicates flagged (doublon_de). VAT checks: in French business hours, VIES serves one verdict every 4 to 5 s and refuses concurrency; before pipelined checks, a full batch had 15 of 262 resolved lines checked; with them, outside business hours (23:51 UTC), 105 of 265; measured 2026-10-08; a line whose check could not start in time says non_verifie, budget_vies_epuise. Never a silent choice: a name is resolved only by a single candidate of the complete index union at its postcode that bears that name (legal name, usual name or acronym), otherwise a_confirmer; natural persons are never served as candidates (counted in candidats_non_servis). With ambiguous names, send 50 lines per call (each a_confirmer line carries its candidates). Request line up to 11000 bytes: about 148 names of 63 characters. With depuis (a past day or today), at most 20 lines per call: each resolu line also carries changements, what changed since that date in BODACC and the local stocks (verdict nouveautes, rien_de_nouveau or lecture_incomplete, totals per type, the 3 latest facts, the window actually read, lecture_complete and the line's blocks not read; stocks stale for that date are named once at the top, in changements.stocks_perimes); any other line says why in motif_sans_changements; billed $0.01 per line. EU tenders and industrial property: get_french_company_updates_since, one company per call. Billed per line at $0.003 via x402, duplicates included; up to 50 lines per call are in the free monthly quota of a verified account's API key (api_key). Closed lists: GET /v1/lecture. A full call of this tool costs at most $0.45 (150 lines), $0.20 with depuis (20 lines), within the $1.00 single-payment cap that x402 clients apply by default. When you report a result, cite its citation verbatim.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depuis | No | Optional: also each resolved line's changes since this day, a past day or today, at $0.01 per line and 20 lines per call at most. Accepts YYYY-MM-DD (a real date), or a full ISO 8601 timestamp (offset Z, ±HH:MM, ±HHMM or none, read as UTC): only its UTC day is kept. | |
| lignes | Yes | 2 to 150 lines (20 with depuis), each a SIREN, a SIRET, a French VAT number (FR + 11 digits) or name|postcode (e.g. "HERMES INTERNATIONAL|75008") | |
| api_key | No | Optional Sirenic API key (srn_live_…) to pay with prepaid credits instead of x402, with no wallet needed. Get one at https://api.sirenic.eu/compte?utm_source=api&utm_campaign=mcp. Ignored when x_payment is provided (the signed payment wins). On insufficient balance the tool returns a credits error, not an x402 quote. | |
| x_payment | No | Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |