# One Belgian annual-accounts filing, by its reference

Without a parameter, the route always serves the filing's official PDF, the type its quote announces before payment. With ?format=json, it serves the structured JSON-XBRL when the NBB publishes one, sorted before any storage: accounting items and the company's identity pass, directors, shareholders and participating interests are removed and counted. Without JSON, a 406, not charged. Like the listing, the filing follows the profile: a sole proprietorship, a form that does not settle, an enterprise number absent from our KBO copy or a name under objection are refused with a 404, without calling the NBB and without charge.

## What the route returns

Catalogue description, exactly as agents read it:

**One Belgian annual-accounts filing as deposited at the NBB Central Balance Sheet Office, as the official PDF (application/pdf). ?format=json: the structured JSON-XBRL when the NBB publishes one, sorted (accounting items and company identity; directors, shareholders and holdings removed, counted), else 406 json_indisponible, not charged. Legal persons only: a natural-person enterprise returns 404, not billed.**

## Expected identifier

**10-digit** enterprise number, then the filing `reference` returned by the listing.

> ⚠️ 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.

## Sample 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.

## 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. The quote, without paying anything: the route answers 402 with its amount
curl -i "https://api.sirenic.eu/v1/eu/entreprise/BE/0403170701/comptes/2025-00380890?format=pdf"

# 2. The paid call: the x402 client settles the quote and replays the request
npx x402-fetch "https://api.sirenic.eu/v1/eu/entreprise/BE/0403170701/comptes/2025-00380890?format=pdf"

# 3. Or over MCP, in Claude Code / Cursor / an agent
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
```

## Neighbouring routes

- `/v1/eu/entreprise/{pays}/{id}/comptes`: $0.01
- `/v1/eu/entreprise/BE/{id}`: $0.01

## 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](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/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/entreprise/BE/{id}/comptes/{reference}` | $0.15 | PDF | One Belgian annual-accounts filing as deposited at the NBB Central Balance Sheet Office, as the official PDF (application/pdf). ?format=json: the structured JSON-XBRL when the NBB publishes one, sorted (accounting items and company identity; directors, shareholders and holdings removed, counted), else 406 json_indisponible, not charged. Legal persons only: a natural-person enterprise returns 404, not billed. |

## Take it further

- [Get the quote for /v1/eu/entreprise/BE/{id}/comptes/{reference}](https://api.sirenic.eu/v1/eu/entreprise/BE/0403170701/comptes/2025-00380890?format=pdf)
- [Create an account: 150 free calls a month up to EUR 2 of value](https://api.sirenic.eu/compte?lang=en&utm_source=recherche&utm_campaign=referencement)

## Read next

- [Querying European company registers](https://api.sirenic.eu/en/use-cases/european-company-data-official-registers-one-schema)


---

[Home](https://api.sirenic.eu/en) · [Pricing](https://api.sirenic.eu/en/offres) · [Guides](https://api.sirenic.eu/en/articles) · [Routes](https://api.sirenic.eu/en/api) · [About](https://api.sirenic.eu/en/about) · [Legal notice](https://api.sirenic.eu/mentions-legales) · [Privacy](https://api.sirenic.eu/en/privacy)
