{"uid":"cap_nBYNSzlWhOIADYfrTU_aY","slug":"french-company-siren-search-by-name-f0357271","name":"French Company SIREN Search by Name","description":"Find a French company's SIREN from its name (optionally a postal code): up to 5 best matches with status, city, NAF, headcount and creation date. Use before /v1/company. Query: ?q=company name&postal_code=75008","url":"https://gdzlcxskuhupymyxywzm.supabase.co/functions/v1/frcompany/v1/search?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":["q"],"properties":{"q":{"type":"string","description":"Company name, 3+ characters"},"postal_code":{"type":"string","description":"Optional 5-digit French postal code"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5pyUdW_1OHUgjyCoeJKjE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for French companies by name (and optional postal code) to retrieve up to 5 best-matching SIREN numbers with status, city, NAF code, headcount, and creation date","exampleAgentPrompt":"Can you find the SIREN number for a French company called 'Carrefour' located in postal code 92300? I need to identify them before running a full company check.","exampleUseCases":[{"title":"KYB onboarding company identification","prompt":"I need to onboard a new French supplier called 'Société Générale de Construction' — can you search for their SIREN number so I can run a full KYB check on them?"},{"title":"Disambiguate similar company names","prompt":"I have a French company named 'Dupont Industries' but I'm not sure which one — search for companies with that name in postal code 75008 Paris and show me the top matches with their status and creation dates."},{"title":"Enrich CRM with French company identifiers","prompt":"We have a new client 'Axa France' in our CRM but no SIREN on file — can you look them up by name and give me their SIREN, NAF code, and headcount?"}],"resultDescription":"Returns up to 5 best-matching French companies with their SIREN number, legal status (active/closed), city, NAF industry code, employee headcount band, and company creation date — sufficient to identify the right entity before calling the full /v1/company KYB endpoint.","failureModes":["Query string under 3 characters returns an error or empty results","Company name too generic returns too many low-confidence matches","Invalid postal code format causes query failure","No matching companies found returns empty array","Rate limiting or payment failure returns 402 error","Non-French companies return no results since registry is France-only"],"whenToPreferThis":"Use this endpoint when you have a French company name but not its SIREN or SIRET number, especially as the first step before calling a full KYB/company details endpoint. Prefer this over direct SIREN lookups when the user knows the company name but not the registration number. It is specifically scoped to French companies in the SIRENE registry and is ideal for onboarding workflows, CRM enrichment, and compliance pipelines requiring French business identification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:04.372Z","isFirstParty":false,"canonicalSlug":"french-company-siren-search-by-name-f0357271"}