# Un dépôt de comptes annuels belge, par sa référence

Sans paramètre, la route sert toujours le PDF officiel du dépôt, le type que son devis annonce avant le paiement. Avec ?format=json, elle sert le JSON-XBRL structuré quand la BNB le publie, trié avant tout stockage : postes comptables et identité de la société passent, administrateurs, actionnaires et participations sont retirés et comptés. Sans JSON, un 406 non facturé. Comme la liste, le dépôt suit la fiche : une entreprise personne physique, une forme qui ne tranche pas, un numéro absent de notre copie de la BCE ou une dénomination visée par une opposition sont refusés en 404, sans appel à la BNB et sans débit.

## Ce que la route rend

Description publiée au catalogue, traduite ici en français (les agents la lisent en anglais, comme toutes nos surfaces de découverte) :

**Un dépôt de comptes annuels belge tel que déposé à la Centrale des bilans de la BNB, en PDF officiel (application/pdf). ?format=json : le JSON-XBRL structuré quand la BNB le publie, trié (postes comptables et identité de la société ; administrateurs, actionnaires et participations retirés, comptés), sinon 406 json_indisponible, non facturé. Personnes morales seulement : une entreprise personne physique rend 404, non facturé.**

## Identifiant attendu

Numéro d'entreprise à **10 chiffres**, puis la `reference` de dépôt rendue par la liste.

> ⚠️ Un identifiant au mauvais format dans le **chemin** rend `400` et **n'est pas facturé**, mais il vous fait perdre un aller-retour. C'est la première cause d'appel raté sur les routes étrangères. Un paramètre de **recherche**, lui, est nettoyé : les caractères non pris en charge sont retirés et la requête utile est servie.

## Extrait de réponse

Cette route n'a pas d'extrait publiable : elle rend un document binaire, ou son exemple attend un achat réel. Le schéma complet reste décrit dans l'OpenAPI.

## Prix et facturation

Tarif : **0,15 €**, débité en crédits (1 crédit = 1 €) ; en x402, le même montant se règle en USDC ou en EURC. Le montant qui fait foi est celui du devis `402` renvoyé par la route elle-même, pas ce texte, qui est dérivé de la même grille mais reste une page.

Une réponse d'erreur **annule le paiement** : un `400`, un `404` ou un `503` n'est jamais facturé. Une panne d'une source amont ferme la route en `503` plutôt que de servir une réponse dégradée.

## Appeler la route

```
# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i "https://api.sirenic.eu/v1/eu/entreprise/BE/0403170701/comptes/2025-00380890?format=pdf"

# 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/BE/0403170701/comptes/2025-00380890?format=pdf"

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

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
```

## Routes voisines

- `/v1/eu/entreprise/{pays}/{id}/comptes` : 0,01 €
- `/v1/eu/entreprise/BE/{id}` : 0,01 €

## Comment on paie

Chaque route se paie **à l'appel**, de deux façons, sans abonnement : en x402, en USDC ou EURC sur le réseau Base, sans compte ni clé d'API ; ou avec la clé d'API d'un compte, qui ouvre le quota gratuit. En x402, le premier appel renvoie un devis `402` que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, dans la limite de 2 € de valeur, sur 122 routes sur 129 (la grille dit lesquelles), plus 100 lignes gratuites par mois sur l'identité en lot, et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.

Les réponses payantes sont **signées Ed25519** : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans [l'OpenAPI](https://api.sirenic.eu/openapi.json) et le [llms.txt](https://api.sirenic.eu/llms.txt).

**Un appel, de bout en bout**

```
# 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

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp
```

## Routes utilisées et prix

| Route | Prix | Exemple | Ce qu'elle rend |
| --- | --- | --- | --- |
| `/v1/eu/entreprise/BE/{id}/comptes/{reference}` | 0,15 € | PDF | Un dépôt de comptes annuels belge tel que déposé à la Centrale des bilans de la BNB, en PDF officiel (application/pdf). ?format=json : le JSON-XBRL structuré quand la BNB le publie, trié (postes comptables et identité de la société ; administrateurs, actionnaires et participations retirés, comptés), sinon 406 json_indisponible, non facturé. Personnes morales seulement : une entreprise personne physique rend 404, non facturé. |

## Passer à l'action

- [Obtenir le devis de /v1/eu/entreprise/BE/{id}/comptes/{reference}](https://api.sirenic.eu/v1/eu/entreprise/BE/0403170701/comptes/2025-00380890?format=pdf)
- [Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur](https://api.sirenic.eu/compte?utm_source=recherche&utm_campaign=referencement)

## À lire ensuite

- [Interroger les registres d'entreprises européens](https://api.sirenic.eu/cas-usage/donnees-entreprises-europeennes-registres-officiels-schema)


---

[Accueil](https://api.sirenic.eu/) · [Offres](https://api.sirenic.eu/offres) · [Articles](https://api.sirenic.eu/articles) · [Routes](https://api.sirenic.eu/api) · [À propos](https://api.sirenic.eu/a-propos) · [Mentions légales](https://api.sirenic.eu/mentions-legales) · [Confidentialité](https://api.sirenic.eu/confidentialite)
