{"uid":"cap_ydbciZ8Wb2xGXoprbJcbi","slug":"sirenic-batch-identity-resolution-french-companies-6a12429b","name":"Sirenic Batch Identity Resolution (French Companies)","description":"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.","url":"https://api.sirenic.eu/v1/identite/lot?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gm_8hv9hwuYx7o8azZKqo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a batch of 2–300 French company identifiers (SIREN, SIRET, VAT, or name+postcode) into full legal identity records with live VAT validation","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"CRM list enrichment before outreach","prompt":"I'm about to launch a B2B campaign targeting 120 French companies — I have a CSV with a mix of SIRENs and company name+postcode pairs; can you resolve them all, flag any that are ceased or unresolvable, and give me the confirmed head-office address and VAT number for each active one?"},{"title":"Accounts-payable supplier verification","prompt":"Before we process payments this month, can you validate these 80 French supplier records? I have their SIRET numbers and VAT numbers mixed in one list — I need to know which are active, which have valid intra-community VAT according to VIES, and flag any duplicates."},{"title":"KYC onboarding batch check","prompt":"We just received registration forms from 35 new French business customers with a mix of SIREN numbers and some just given as name and postcode — can you run them all through Sirenic to get their legal status, head-office SIRET, and whether they're currently active or have ceased trading?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:40:57.334Z","isFirstParty":false,"canonicalSlug":"sirenic-batch-identity-resolution-french-companies-6a12429b"}