GET/v1/entreprise/{siren}/capital
- Price
- $0.35
- Free quota
- No
- Family
- France · finances and risk
| Parameter | Where | Example |
|---|---|---|
siren | path · required | 552032534 |
What is charged
200Ed25519-signed response, charged at the route's price402Signed x402 quote, nothing is debited4xxUnknown or invalid identifier, never charged5xxUpstream source unavailable, never charged
See a real response (free) Get the quote for /v1/entreprise/{siren}/capital
What the route returns
Catalogue description, exactly as agents read it:
Ownership and share capital of a French company, AI-extracted from the latest PUBLIC articles of association filed at the INPI: share capital, legal form, shareholders (CORPORATE holders named with role and %; natural persons COUNTED with their %, never named (GDPR) since 2026-09-19), notable clauses, confidence, source document. From public filed deeds, NOT a beneficial-ownership register (RBE) nor a beneficial-owner identification. Cached; 90 days at most when natural persons are counted.
Expected identifier
9-digit company number.
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.35. 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
This is not a beneficial-ownership register and does not replace one. Since 19 September 2026, natural-person shareholders are counted, never named (associes_personnes_physiques, detenu_par_personnes_physiques_pct); legal entities are named. Filed articles can be old: an unpublished share transfer does not appear. The extraction is cached; when it counts natural-person shareholders, it is deleted after 90 days or as soon as newer articles are filed, then redone on request. Read it as a dated exhibit, never as the current shareholding.
Neighbouring routes
/v1/entreprise/{siren}/documents: $0.02/v1/eu/entreprise/GB/{company_number}/beneficiaires-effectifs: $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
# 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
Routes used and pricing
| Route | Price | Sample | What it returns |
|---|---|---|---|
/v1/entreprise/{siren}/capital | $0.35 | free sample | Ownership and share capital of a French company, AI-extracted from the latest PUBLIC articles of association filed at the INPI: share capital, legal form, shareholders (CORPORATE holders named with role and %; natural persons COUNTED with their %, never named (GDPR) since 2026-09-19), notable clauses, confidence, source document. From public filed deeds, NOT a beneficial-ownership register (RBE) nor a beneficial-owner identification. Cached; 90 days at most when natural persons are counted. |
The ownership data served for France is not a beneficial-ownership register and does not replace one: the French register has not been publicly accessible since the 2022 ruling of the Court of Justice of the European Union. What is served comes from publicly filed deeds.
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/entreprise/{siren}/capital Get notified about euro packs