API to download a document filed with the register (PDF)

GET/v1/documents/{type}/{id}

Price: $0.10
Free quota: No
Family: France · identity, documents

Parameters
Parameter	Where	Example
`type`	path · required	`bilans`
`id`	path · required	`6a33a929f9e4b401ad07b51a`

What is charged

200Ed25519-signed response, charged at the route's price
402Signed x402 quote, nothing is debited
4xxUnknown or invalid identifier, never charged
5xxUpstream source unavailable, never charged

Get the quote for /v1/documents/{type}/{id}

curlx402MCPPythonJS

curl "https://api.sirenic.eu/v1/documents/bilans/6a33a929f9e4b401ad07b51a" \
  -H "X-Api-Key: $SIRENIC_KEY" \
  -o document.pdf

# 1. The quote, without paying anything: the route answers 402 with its amount
curl -i "https://api.sirenic.eu/v1/documents/bilans/6a33a929f9e4b401ad07b51a"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/documents/bilans/6a33a929f9e4b401ad07b51a"

# Or over MCP, in Claude Code / Cursor / an agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

import os, requests

r = requests.get(
    "https://api.sirenic.eu/v1/documents/bilans/6a33a929f9e4b401ad07b51a",
    headers={"X-Api-Key": os.environ["SIRENIC_KEY"]},
)
open("document.pdf", "wb").write(r.content)

const r = await fetch("https://api.sirenic.eu/v1/documents/bilans/6a33a929f9e4b401ad07b51a", {
  headers: { "X-Api-Key": process.env.SIRENIC_KEY },
});
const pdf = new Uint8Array(await r.arrayBuffer());

Response

This route has no publishable sample: it returns a binary document, or its sample awaits a real purchase. The full schema is still described in the OpenAPI document.

What the route returns

Catalogue description, exactly as agents read it:

PDF download of official documents from the French INPI RNE registry, by type (actes | bilans) and document ID from the document list endpoint. Filed annual accounts (bilans): any payer. Legal deeds (actes: statutes, general-meeting minutes) are RESERVED to identified Sirenic accounts (API key) since 2026-09-19 because they carry personal data — 401 otherwise, nothing charged. 1-10 MB, streamed as-is at request time (application/pdf), never stored: the primary-source evidence, not a summary.

Expected identifier

Two segments: the document type and its id, both taken from the listing route's response. Do not guess them.

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.10. 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

Binary output, and no certified-copy legal status. This route issues no Kbis extract. Since 19 September 2026, deeds (statutes, minutes) are reserved to identified accounts — API key, $0.10 in credits — because they carry personal data; an anonymous call gets a 401 with no quote. Filed accounts remain open to x402 payment.

Neighbouring routes

/v1/entreprise/{siren}/documents: $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/documents/{type}/{id}`	$0.10	PDF	PDF download of official documents from the French INPI RNE registry, by type (actes \| bilans) and document ID from the document list endpoint. Filed annual accounts (bilans): any payer. Legal deeds (actes: statutes, general-meeting minutes) are RESERVED to identified Sirenic accounts (API key) since 2026-09-19 because they carry personal data — 401 otherwise, nothing charged. 1-10 MB, streamed as-is at request time (application/pdf), never stored: the primary-source evidence, not a summary.

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.

Get the quote for /v1/documents/{type}/{id} Get notified about euro packs

Download a filed document