{"uid":"cap_jKv9Og-3IgcI3t9JrWEIp","slug":"sirenic-annual-account-filing-7b36d872","name":"Sirenic Annual Account Filing","description":"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.","url":"https://api.sirenic.eu/v1/eu/entreprise/:pays/:id/comptes/:reference?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_samAChSrUtNuJ540rgpoq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Belgian supplier financial due diligence","prompt":"Get me the latest annual filing for Belgian company 0403294064 using deposit reference 2023-12345678 — I want revenue, net result, equity, and total assets from the structured JSON."},{"title":"Finnish company earnings review","prompt":"Fetch the annual accounts for Finnish company 0103396-3 for the fiscal year ending 2024-12-31 — I need revenue, operating result, net result, and equity including prior-year comparatives."},{"title":"Older Belgian filing as PDF","prompt":"Retrieve the official PDF of the annual accounts deposit for Belgian enterprise 0471938156, reference 2019-87654321 — it's an older filing so I need the PDF format."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T18:47:08.938Z","isFirstParty":false,"canonicalSlug":"sirenic-annual-account-filing-7b36d872"}