# Sirenic UK iXBRL Accounts Decoder

> Sirenic UK iXBRL Accounts Decoder is a paid API for AI agents from api.sirenic.eu, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-10).

Retrieves one UK financial year of decoded iXBRL accounts for a Companies House-registered company, including balance sheet, P&L (when filed), and prior-year comparatives.

## Facts

- Endpoint: GET https://api.sirenic.eu/v1/eu/entreprise/GB/:company_number/comptes/:date_cloture?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sirenic-uk-ixbrl-accounts-decoder-22d7df00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2Zkuyu_Al9U1o7Hhp-lsp

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-uk-ixbrl-accounts-decoder-22d7df00
```

Example prompt: Pull the decoded iXBRL accounts for UK company number 07960839 for the financial year ending 2023-03-31 — I need the full balance sheet with assets, creditors, net assets, equity, and the profit and loss account if it was filed.

## When to prefer this

Use this endpoint when you need structured, machine-readable financial data from UK Companies House iXBRL filings — specifically balance sheet and P&L figures for a known company number and filing date. Prefer it over screen-scraping Companies House directly (which returns raw HTML/iXBRL), and over generic company data APIs that don't decode iXBRL into clean line items. Best suited for due diligence, credit risk, financial benchmarking, or investor reporting workflows where you need precise accounting figures with prior-year comparatives.

## Known failure modes

- Company number not found at Companies House — 404 or empty response
- Date does not match a known filing balance sheet date — no matching accounts period returned
- Company filed balance-sheet-only accounts (small company exemption) — P&L fields will be null
- iXBRL filing not yet processed or unavailable — may return partial data
- Invalid company number format (not 8 characters with leading zeros) — validation error
- Payment not processed (x402 protocol failure) — 402 response, no data returned

## How this service works

One United Kingdom financial year from the iXBRL financial statements filed at Companies House: balance sheet (fixed and current assets, stocks, debtors, cash, creditors split by maturity, provisions, net assets, equity), average employees, the profit and loss when filed (turnover, operating, pre-tax and net result — most small companies file a balance sheet only), plus prior-year comparatives as published. Filing currency, null = not published, never zero. Open Government Licence v3.0.

## Output

A structured JSON object containing one UK financial year of decoded iXBRL data: balance sheet line items (fixed assets, current assets broken down by stocks/debtors/cash, creditors split by maturity, provisions, net assets, equity), average employee count, and — where the company filed a full set — the profit and loss account (turnover, operating result, pre-tax result, net result). Prior-year comparative figures are included as published. All monetary values carry the filing currency; null values indicate data not published in the filing (never zero-padded).

## 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": [
      "company_number",
      "date_cloture"
     ],
     "properties": {
      "date_cloture": {
       "type": "string",
       "description": "Balance-sheet date YYYY-MM-DD from the filings list, e.g. 2026-03-31"
      },
      "company_number": {
       "type": "string",
       "description": "8-character Companies House number, leading zeros included, e.g. 07960839"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "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-uk-ixbrl-accounts-decoder-22d7df00/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)