{"uid":"cap_XzM-uvGa2y6ExFP0oLAUX","slug":"french-company-registry-lookup-sirene-e0d9d554","name":"French Company Registry Lookup (SIRENE)","description":"French company lookup in the official SIRENE register (Annuaire des Entreprises) by SIREN, SIRET or company name. Returns legal name, active/ceased status, legal form, creation date, head-office address and NAF activity code in a schema shared across countries.","url":"https://companies.use.x402atlas.com/french-company-data?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":["query"],"properties":{"query":{"type":"string","maxLength":200,"minLength":3,"description":"Company registration number (French SIREN or SIRET, e.g. 552032534) or company name"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["country","registry","query","matched_by","count","companies"],"properties":{"note":{"type":"string","description":"Hint present only on the sample response (empty/omitted query) and on a zero-match response"},"count":{"type":"integer","description":"Number of entries in companies"},"query":{"type":"string","description":"Echoed query (trimmed)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code of the route's country"},"registry":{"type":"string","description":"Official registry the result comes from"},"companies":{"type":"array","items":{"type":"object","required":["name","registration_number","status","legal_form","founded","address","activities","website"],"properties":{"name":{"type":"string","description":"Current legal name"},"status":{"enum":["active","inactive","unknown"],"type":"string","description":"Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown"},"address":{"type":"object","required":["street","postal_code","city","country_code"],"properties":{"city":{"type":["string","null"],"description":"City or post town"},"street":{"type":["string","null"],"description":"Street and house number"},"postal_code":{"type":["string","null"],"description":"Postal code"},"country_code":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 country code of the address"}},"description":"Registered (head-office) address; each part is null when the registry does not supply it"},"founded":{"type":["string","null"],"format":"date","description":"Founding / registration date (YYYY-MM-DD)"},"website":{"type":["string","null"],"description":"Company website as registered; may lack a URL scheme"},"activities":{"type":"array","items":{"type":"object","required":["code","description"],"properties":{"code":{"type":"string","description":"Registry activity code (NACE, NAF or SIC, as the registry publishes it)"},"description":{"type":["string","null"],"description":"Activity description; null when the registry supplies only the code"}}},"maxItems":5,"description":"Up to 5 registered activities, main activity first when the registry marks one; empty when none are published"},"legal_form":{"type":["string","null"],"description":"Legal form as the registry names it, or the registry's legal-form code when it publishes no name"},"registration_number":{"type":"string","description":"Canonical national registration number (BE enterprise number, FR SIREN, GB company number, NO organisasjonsnummer, FI business ID, CZ ICO)"}}},"maxItems":5,"description":"Matching companies; empty when nothing matched (still HTTP 200)"},"matched_by":{"enum":["number","name"],"type":"string","description":"number: the query was read as a registration number (exact lookup, 0 or 1 company); name: company-name search (up to 5 companies)"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hFQWXg-DZU_U56Z67UAuo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up French companies in the official SIRENE register by SIREN/SIRET number or company name, returning legal details in a standardized schema.","exampleAgentPrompt":"Can you look up the French company with SIREN number 552032534 in the official SIRENE register and tell me its legal name, current status, registered address, and activity code?","exampleUseCases":[{"title":"Verify French supplier legitimacy","prompt":"I need to verify that our French supplier 'Renault SAS' is still an active company — can you look them up in the French SIRENE registry and confirm their legal status, address, and company registration number?"},{"title":"KYB due diligence on French entity","prompt":"We're onboarding a new French business partner with SIRET number 77573006200034 — can you pull their official registry details including legal form, founding date, and registered address from the French SIRENE database?"},{"title":"Enrich CRM with French company data","prompt":"I have a French company called 'Carrefour SA' in my CRM with no registration details — can you find their SIREN number, NAF activity code, and head-office address from the official French company registry?"}],"resultDescription":"Returns a structured JSON object with: echoed query, ISO country code ('FR'), registry name ('SIRENE'), match count, and an array of matching companies each containing legal name, SIREN/SIRET registration number, normalized status (active/inactive/unknown), legal form, founding date, structured head-office address (street, postal code, city, country code), NAF activity codes, and website if available.","failureModes":["No matches found: returns companies array as empty with count=0 and a note field explaining zero results","Invalid or malformed SIREN/SIRET: may return no matches or an error response","Query string too short (<3 characters) or too long (>200 characters): rejected by schema validation","Company name ambiguity: may return multiple results requiring further filtering","SIRENE registry temporarily unavailable: upstream data source error","Payment failure: x402 payment not processed, endpoint returns 402"],"whenToPreferThis":"Use this endpoint when you specifically need to look up French companies registered in the official SIRENE/Annuaire des Entreprises registry. Prefer it over generic web search when you need structured, authoritative legal data (registration number, legal form, official status) for KYB, due diligence, CRM enrichment, or compliance workflows. It shares a consistent schema with sibling endpoints for other countries (UK, Belgium, Norway, etc.), making it ideal for multi-country company verification pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:31:13.397Z","isFirstParty":false,"canonicalSlug":"french-company-registry-lookup-sirene-5936a27c"}