# Récupérer un dépôt de comptes par sa référence

La seconde moitié d'un enchaînement à deux temps : la liste dit ce qui existe, cette route sert le dépôt choisi. Le point d'intégration à respecter est que la référence doit venir de la réponse de la liste, sous le nom exact de paramètre attendu ici — une référence reconstruite à la main échoue.

## Ce que la route rend

Description publiée au catalogue, telle que les agents la lisent (en anglais, comme toutes nos surfaces de découverte) :

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

## Identifiant attendu

Code pays, identifiant national, puis la `reference` de dépôt rendue par la liste.

> ⚠️ Un identifiant au mauvais format 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.

## Extrait d'une réponse réellement payée

Photo datée du 29/07/2026, tronquée à un élément par tableau. Ce n'est pas une donnée en direct. L'extrait complet est servi **gratuitement** par [la surface d'exemples](https://api.sirenic.eu/exemples/), et le schéma par l'OpenAPI.

```
{
 "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)"
}
```

## Prix et facturation

Tarif : **$0.15**. 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/{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
```

## Routes voisines

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

## Comment on paie

Chaque route se paie **à l'appel**, en USDC ou EURC sur le réseau Base, par le protocole x402 : pas de compte à créer, pas de clé d'API, pas d'abonnement. Le premier appel renvoie un devis `402` que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Vous préférez une facture en euros et des crédits prépayés ? C'est **en préparation** et nous n'annonçons pas de date tant que ce n'est pas ouvert. Écrivez à [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Packs%20en%20euros) et vous serez prévenu à l'ouverture.

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

## Routes utilisées et prix

| Route | Prix | Ce qu'elle rend |
| --- | --- | --- |
| `/v1/eu/entreprise/{pays}/{id}/comptes/{reference}` | $0.15 | 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. |

## Passer à l'action

- [Voir une réponse réelle (gratuit)](https://api.sirenic.eu/exemples/eu-entreprise-pays-id-comptes-reference.json)
- [Obtenir le devis de /v1/eu/entreprise/{pays}/{id}/comptes/{reference}](https://api.sirenic.eu/v1/eu/entreprise/{pays}/{id}/comptes/{reference})
- [Être prévenu des packs en euros](mailto:contact@sirenic.eu?subject=Packs%20en%20euros)

## À lire ensuite

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

---

Les volumes cités sur cette page ont été mesurés en base le 19/08/2026. Ce sont des photos datées, pas des compteurs en direct.

Catalogue complet : https://api.sirenic.eu/