# Sirenic Batch Identity Resolution (French Companies)

> Sirenic Batch Identity Resolution (French Companies) is a paid API for AI agents from api.sirenic.eu, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Resolves a batch of 2–300 French company identifiers (SIREN, SIRET, VAT, or name+postcode) into full legal identity records with live VAT validation

## Facts

- Endpoint: GET https://api.sirenic.eu/v1/identite/lot?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sirenic-batch-identity-resolution-french-companies-6a12429b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ydbciZ8Wb2xGXoprbJcbi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sirenic-batch-identity-resolution-french-companies-6a12429b
```

Example prompt: I have a list of 50 French company identifiers — a mix of SIRENs, SIRETs, VAT numbers, and some name+postcode pairs — can you resolve them all at once and tell me which ones are active, their head-office addresses, and whether their VAT numbers check out on VIES?

## When to prefer this

Choose this endpoint when you need to resolve a batch of 2–300 French company identifiers in a single call, especially when input is heterogeneous (mixing SIREN, SIRET, VAT numbers, and name+postcode). It is the right choice for CRM enrichment, KYC onboarding, supplier verification, and any workflow where French legal identity plus live VAT validation are needed together. For a single company lookup with additional data blocks, the full company file endpoint may be preferable. For non-French EU VAT-only validation, use the standalone VIES endpoint.

## Known failure modes

- Fewer than 2 or more than 300 lines returns an error
- SIREN not found in INSEE registry returns siren_inconnu
- Invalid SIREN format returns siren_invalide
- Company marked non-diffusible by INSEE returns non_diffusible status
- Ambiguous name+postcode with multiple candidates returns a_confirmer with up to 5 ranked options
- VIES service temporarily unavailable returns indisponible for VAT check
- VIES budget exhausted returns budget_vies_epuise (never a false invalide)
- Malformed query string or missing lignes parameter returns HTTP error

## How this service works

Batch identity for French customer/CRM lists: 2 to 300 lines (SIREN, SIRET, FR VAT number or name|postcode), in file order. Per line: resolution (resolu, a_confirmer with up to 5 ranked candidates, introuvable, siren_invalide, siren_inconnu, non_diffusible), SIREN, HQ SIRET, status, cessation date, address, VAT checked live on VIES (indisponible or budget_vies_epuise, never a false invalide), duplicates. $0.003 per line, up to $0.90; with depuis (changes since a date) $0.01, up to $3.00.

## Output

For each input line (in file order), returns: resolution status (resolu, a_confirmer with up to 5 ranked candidates, introuvable, siren_invalide, siren_inconnu, or non_diffusible), SIREN, head-office SIRET, legal status, cessation date if applicable, registered address, live VIES VAT check result (valid/invalid/indisponible/budget_vies_epuise), and a duplicate flag. Input names are never echoed back.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lignes"
     ],
     "properties": {
      "depuis": {
       "type": "string",
       "description": "Optional: a past day or today, YYYY-MM-DD or a full ISO 8601 timestamp (its UTC day is kept). Each resolu line then also carries changements, what changed for its company since that day (BODACC and local stocks), and every line is billed at the depuis price."
      },
      "lignes": {
       "type": "string",
       "description": "2 to 300 lines separated by ';', in file order, each a SIREN, a SIRET, a French VAT number (FR + 11 digits) or name|postcode. Billed PER LINE, duplicates included: the signed quote is $0.003 x the number of lines (up to $0.90), $0.01 x the number of lines with depuis (up to $3.00)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sirenic-batch-identity-resolution-french-companies-6a12429b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sirenic.eu](https://www.zero.xyz/host/api.sirenic.eu/llms.txt)