# Sirenic Annual Account Filing

> Sirenic Annual Account Filing is a paid API for AI agents from api.sirenic.eu, paid per call via x402, $0.15/call, status unknown (last checked 2026-10-13).

Retrieves one annual account filing for a Belgian or Finnish company — structured JSON (BE deposits since April 2022) or official PDF (older BE filings), including revenue, results, equity, assets, and debts with prior-year comparatives.

## Facts

- Endpoint: GET https://api.sirenic.eu/v1/eu/entreprise/:pays/:id/comptes/:reference?utm_source=zero.xyz
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sirenic-annual-account-filing-7b36d872
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jKv9Og-3IgcI3t9JrWEIp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sirenic-annual-account-filing-7b36d872
```

Example prompt: Pull the annual accounts for Belgian company 0403294064, deposit reference 2023-12345678 — I need the structured JSON with revenue, net result, equity, and total assets.

## When to prefer this

Use this endpoint when you need the full structured financial statements (balance sheet, P&L) for a specific fiscal year of a Belgian or Finnish company, referenced by the exact deposit reference or closing date obtained from the Sirenic filings-list endpoint. Prefer this over general company-info endpoints when you need income statement and balance sheet line items, prior-year comparatives, or the official PDF of the filing.

## Known failure modes

- Invalid or unknown enterprise number returns 404
- Deposit reference not found for that company returns 404
- Country code other than BE or FI returns 400 or unsupported error
- Requesting structured JSON for a pre-April 2022 BE filing without ?format=pdf may return PDF or error
- Malformed reference format (wrong date pattern or reference string) returns 400
- Payment not completed (x402 protocol) returns 402 before data is delivered

## How this service works

One annual-account filing — Belgian or Finnish company financial statements. BE: the deposit as filed at the NBB CBSO — structured JSON when the NBB publishes one, official PDF otherwise (?format=pdf forces the PDF; ?format=json refuses the fallback and answers 406, not charged). FI: one fiscal year decoded from the PRH XBRL filing — revenue, results, equity, assets, debts, prior-year figures (EUR, CC BY 4.0). Reference: BE deposit ref or FI closing date, from the filings list.

## Output

For BE (post-April 2022): structured JSON from the NBB CBSO deposit containing balance sheet and income statement items (revenue, operating result, net result, equity, total assets, debts) with prior-year comparatives. For BE (older) or when ?format=pdf is used: the official PDF of the deposit. For FI: structured JSON decoded from the PRH XBRL filing with the same financial KPIs and prior-year comparatives, denominated in EUR under CC BY 4.0.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "pays",
      "id",
      "reference"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "BE: 10-digit enterprise number. FI: Business ID NNNNNNN-N, e.g. 0103396-3"
      },
      "pays": {
       "type": "string",
       "description": "BE or FI only on this pattern"
      },
      "reference": {
       "type": "string",
       "description": "BE: deposit reference YYYY-NNNNNNNN taken from the `reference` field of the filings list. FI: closing date YYYY-MM-DD taken from `date_cloture`, e.g. 2024-12-31"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "format": {
       "type": "string",
       "description": "BE only, optional. `pdf` forces the official PDF instead of the structured JSON; `json` refuses the PDF fallback and answers 406 (not charged) when the filing has no JSON representation"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sirenic-annual-account-filing-7b36d872/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sirenic.eu](https://www.zero.xyz/host/api.sirenic.eu/llms.txt)