GET/v1/eu/recherche
- Price
- $0.003
- Free quota
- Included
- Family
- Europe · search and profiles
| Parameter | Where | Example |
|---|---|---|
q | query · required | equinor |
pays | query · optional | NO |
What is charged
200Ed25519-signed response, charged at the route's price402Signed x402 quote, nothing is debited4xxInvalid parameter or query too broad (requete_trop_large), never charged5xxUpstream source unavailable, never charged
See the reconstructed example (free) Get the quote for /v1/eu/recherche
What the route returns
Catalogue description, exactly as agents read it:
Name search, European registers. Local copies, all searched without pays: Belgium, Croatia, Cyprus, Estonia, Ireland, Latvia, Lithuania, Norway, Romania, Sweden, Spain (BORME); live only with pays set: Czechia, Finland, Slovakia, Switzerland; Poland through GLEIF; DK/UK if enabled; +GLEIF. Top 10, score_confiance. BE, CH, CZ, DK, EE, HR, LT, LV, NO, RO, SE, SK: legal persons only (no FIE, ENK, IK), nor ES sole traders; no GLEIF sole proprietor or CH branch (ecartes; ecartes_non_mesures (LV/NO)).
Expected identifier
None: a name of at least two characters, plus an optional pays filter as a two-letter ISO code.
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.
Price and billing
Price: $0.003. 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.
What this route does not do
Germany and the Netherlands are out of scope for this search. Legal Entity Identifier coverage gives financial entities and large groups, not the small local company. In Czechia and Slovakia only legal persons are served: a sole trader or a form not recognised as a legal person is left out, never named; in Slovakia, it is counted in ecartes; in Czechia, the register is queried for legal persons only: the others are neither read nor counted, and the response says so with ecartes_filtres_amont. In Estonia too, only legal persons are served: a sole proprietorship (FIE) or a form not recognised as a legal person is left out and counted the same way. In Norway as well, only legal persons are served, read before the cut of candidates: a sole proprietorship (ENK), a registered individual, an estate named after a person (KBO, BO) or a form not recognised as a legal person is kept in our copy without its name, so the search can no longer match it: it is neither served nor counted, and the response says so with ecartes_non_mesures (LV, Latvia; NO, Norway); a foreign branch or entity (NUF, UTLA) whose name does not end with a written legal-person form valid in its home country (followed at most by branch words), or recorded there as a sole proprietorship is left out, counted while the copy keeps its name (the collection run after lot I22 B keeps only its skeleton, which the search no longer matches). In Latvia too, only legal persons are served: an individual merchant (IK), an individual, family, farm or fishery enterprise, or a form not recognised as a legal person is kept in our copy without its name, as in Norway. In Switzerland, a sole proprietorship (Einzelunternehmen), whose name carries the owner's name, a branch (the search does not know its head office) or an undecided legal form is left out and counted the same way. In Croatia too only legal persons are served: a sole trader or an undecided form is left out and counted the same way; in Belgium, an entity without legal form (a natural-person enterprise), and in Spain, the sheet of a sole trader (an « empresario individual » act), too. In every country, a Legal Entity Identifier that GLEIF itself flags as a natural person (sole proprietor) is left out the same way, as is one whose legal form does not say whether the entity is a natural or a legal person. The search does not even ask GLEIF for the sole proprietor category: those are neither read nor counted, and the response says so with ecartes_filtres_amont.
Neighbouring routes
/v1/eu/entreprise/{pays}/{id}: $0.01/v1/recherche: $0.002
How you pay
Every route is paid per call, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota. Over x402, the first call returns a 402 quote your client settles, then replays the call. A failed call is never billed.
Open today: 150 free calls a month with an account, up to EUR 2 of value, on 122 of 129 routes (the price list says which), with 100 more free lines a month on batch identity, and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.
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
# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534
# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp
# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
Routes used and pricing
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/eu/recherche | $0.003 | free sample | Name search, European registers. Local copies, all searched without pays: Belgium, Croatia, Cyprus, Estonia, Ireland, Latvia, Lithuania, Norway, Romania, Sweden, Spain (BORME); live only with pays set: Czechia, Finland, Slovakia, Switzerland; Poland through GLEIF; DK/UK if enabled; +GLEIF. Top 10, score_confiance. BE, CH, CZ, DK, EE, HR, LT, LV, NO, RO, SE, SK: legal persons only (no FIE, ENK, IK), nor ES sole traders; no GLEIF sole proprietor or CH branch (ecartes; ecartes_non_mesures (LV/NO)). |
Take it further
The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota.
See the reconstructed example (free) Get the quote for /v1/eu/recherche Create an account: 150 free calls a month up to EUR 2 of value