Fetch an accounts filing by its reference

The second half of a two-step chain: the listing says what exists, this route serves the chosen filing. The integration rule is that the reference must come from the listing's response, under the exact parameter name expected here — a hand-built reference fails.

See a real response (free) Get the quote for /v1/eu/entreprise/{pays}/{id}/comptes/{reference}

What the route returns

Catalogue description, exactly as agents read it:

One annual-account filing — Belgian or Finnish company financial statements. BE: the deposit as filed at the NBB CBSO — structured JSON for deposits published since April 2022, official PDF for older filings (?format=pdf to force). FI: one fiscal year decoded from the PRH XBRL filing — revenue, operating and net result, equity, total assets, debts, plus prior-year comparatives as published (EUR, CC BY 4.0). Reference = BE deposit reference or FI closing date (YYYY-MM-DD), from the filings list.

Expected identifier

Country code, national identifier, then the filing reference returned by the listing.

A wrongly formatted identifier 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.

Extract from a genuinely paid response

Dated snapshot from 2026-07-29, 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.

{
 "pays": "FI",
 "id_national": "0103396-3",
 "date_cloture": "2024-12-31",
 "exercice": {
  "date_cloture": "2024-12-31",
  "debut_exercice": "2024-01-01",
  "denomination": "Arkkitehtitoimisto HKP Oy",
  "chiffre_affaires": 582458.35,
  "resultat_exploitation": -54382.16,
  "resultat_net": -48510.86,
  "capitaux_propres": 482422.26,
  "total_actif": 594206.51,
  "dettes": 111784.25,
  "exercice_precedent": {
   "chiffre_affaires": 1128645.82,
   "resultat_net": 26876.86
  }
 },
 "source": "PRH / avoindata.prh.fi — Patentti- ja rekisterihallitus (Finnish Patent and Registration Office), licence CC BY 4.0",
 "disclaimer": "Comptes annuels finlandais LORSQU'ILS SONT DÉPOSÉS EN XBRL au PRH (~5 % des sociétés à responsabilité limitée)"
}

Price and billing

Price: $0.15. 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/eu/entreprise/{pays}/{id}/comptes/{reference}

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/eu/entreprise/{pays}/{id}/comptes/{reference}

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

Neighbouring routes

• /v1/eu/entreprise/{pays}/{id}/comptes — $0.01

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

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/eu/entreprise/{pays}/{id}/comptes/{reference} Get notified about euro packs

Read next

• Querying European company registers