{"uid":"cap_kiOGF8yNeN6m6nfLpJLju","slug":"french-company-registry-lookup-sirene-5936a27c","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/fr?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_j-7KCOaf1mC_tVMT2ZbJk","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, or company name, returning legal details, status, address, and NAF activity code.","exampleAgentPrompt":"Can you look up the French company with SIREN number 552032534 in the SIRENE register and tell me its legal name, current status, registered address, and NAF activity code?","exampleUseCases":[{"title":"Verify French supplier before onboarding","prompt":"I need to verify a French supplier before we sign a contract — can you check the SIRENE register for the company called 'Carrefour SA' and confirm it's still active, get its legal form and head-office address?"},{"title":"Due diligence on French acquisition target","prompt":"We're doing due diligence on a potential acquisition — look up SIREN 542107651 in the French company registry and give me the full legal details including founding date, status, and registered address."},{"title":"Enrich CRM with French company data","prompt":"I have a French company in our CRM with SIRET number 55203253400048 — can you pull its official details from the SIRENE register so I can fill in the legal name, NAF code, and current status?"}],"resultDescription":"Returns a JSON object with ISO country code (FR), registry name (SIRENE), echoed query, match count, and an array of company records each containing: current legal name, registration number, normalized status (active/inactive/unknown), legal form, founding date, structured head-office address (street, postal code, city, country code), NAF activity code(s), and website if available.","failureModes":["No matching company found for the given SIREN/SIRET/name — returns count:0 with a note","Invalid or malformed SIREN/SIRET number format — query rejected or zero results","Company exists but registry data is incomplete — some fields may be null","SIRENE register temporarily unavailable — upstream API error","Query string too short (under 3 characters) or too long (over 200 characters) — validation error","Payment failure via x402 — call not executed"],"whenToPreferThis":"Choose this endpoint when you specifically need to look up French companies in the official SIRENE/Annuaire des Entreprises register. Prefer it over generic business data providers when you need authoritative French government registry data including NAF codes, legal form, and official status. Use this rather than sibling endpoints (UK, Belgium, Norway, etc.) when the target company is registered in France. Best for compliance, due diligence, supplier verification, and CRM enrichment workflows involving French legal entities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:46:35.336Z","isFirstParty":false,"canonicalSlug":"french-company-registry-lookup-sirene-5936a27c"}