Search a French company

This is the gateway to everything else: without a company number, no other route can work. The useful particularity here is the 0-to-1 confidence score: for a name like “Martin”, ten companies answer, and it is that score that tells you which one you meant.

See a real response (free) Get the quote for /v1/recherche

What the route returns

Catalogue description, exactly as agents read it:

French company search and company lookup by name or SIREN in the official French company registry (INSEE Sirene / INPI RNE open data). Name search returns the top 10 matches with identity, SIREN, NAF code, city and active/ceased status, plus a score_confiance (0-1 match confidence) that helps disambiguate homonyms. The entry point to official data and company data on France: resolve a trading name to its SIREN identifier before pulling the full company profile, filings or financials.

Expected identifier

No identifier: a free-text query parameter. A SIREN, SIRET or French VAT number is also accepted — spaced or labelled ("SIREN: 552 032 534") — and returns the matching company directly.

A wrongly formatted identifier in the path returns 400 and is not billed — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes. A search parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

Extract from a genuinely paid response

Dated snapshot from 2026-08-19, truncated to one item per array. It is not live data. The full extract is served free of charge from the samples surface, and the schema from the OpenAPI document.

{
 "total_results": 10,
 "resultats": [
  {
   "siren": "552032534",
   "denomination": "DANONE",
   "statut_diffusion": "totale",
   "etat_administratif": "actif",
   "activite_principale": "70.10Z",
   "commune_siege": "PARIS",
   "code_postal_siege": "75009",
   "score_confiance": 1
  }
 ],
 "source": "INSEE Sirene / INPI RNE via recherche-entreprises.api.gouv.fr, licence ouverte Etalab 2.0",
 "disclaimer": "Données issues de l'open data, fournies en l'état sans garantie. / Open data, provided as is without warranty.",
 "etages_abandonnes": [],
 "data_freshness": "stock Sirene mensuel (2026-08-01), dirigeants temps réel"
}

Price and billing

Price: $0.002. The authoritative amount is the one in the 402 quote returned by the route itself — not this text, which derives from the same grid but is still just a page.

An error response cancels the payment: a 400, 404 or 503 is never billed. An upstream outage closes the route with a 503 rather than serving a degraded response.

Calling the route

# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/recherche

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/recherche

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

What this route does not do

If your only need is resolving a name to an identifier, a free public API does it just as well — we say so in our comparison. Pay for this route when you chain, in the same transaction, into what that free API does not serve.

Neighbouring routes

/v1/entreprise/{siren} — $0.005
/v1/prospection — $0.02
/v1/dirigeant/recherche — $0.02

How you pay

Every route is paid per call, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a 402 quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is in preparation, and we will not announce a date until it is open. Write to contact@sirenic.eu and we will let you know when it opens.

Paid responses are Ed25519-signed: you can later prove what was served to you, and when. The whole catalogue is free to read in the OpenAPI document and in llms.txt.

One call, end to end

# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

Routes used and pricing

Route	Price	Sample	What it returns
`/v1/recherche`	$0.002	free sample	French company search and company lookup by name or SIREN in the official French company registry (INSEE Sirene / INPI RNE open data). Name search returns the top 10 matches with identity, SIREN, NAF code, city and active/ceased status, plus a score_confiance (0-1 match confidence) that helps disambiguate homonyms. The entry point to official data and company data on France: resolve a trading name to its SIREN identifier before pulling the full company profile, filings or financials.

Take it further

No account to create, no key to request: the first step is free and shows you exactly what you would be buying.

See a real response (free) Get the quote for /v1/recherche Get notified about euro packs