---
title: "The company's latest filed accounts read into plain figures, this year and last"
method: GET
path: "/api/v1/accounts"
---

# The company's latest filed accounts read into plain figures, this year and last

`GET /api/v1/accounts`

## Request

- Base URL: `https://meetkatalis.com`
- URL: `https://meetkatalis.com/api/v1/accounts`
- Auth: API key in header `x-api-key`

From Companies House's tagged (iXBRL) accounts document - net assets, current assets, cash, debtors, creditors due within and after a year, equity, turnover and profit where the accounts include them, average employees, for the current and prior period; audit status, standards, dormant flag; what the accounts leave out. Accounts filed as a PDF can't be read and the call's credits go back. 2 credits.

## Query parameters

- `company` string, required

## Response `200`

company, filed, readable, accounts {filedOn, madeUpTo, kind, period, priorPeriod, standards, audited, auditExempt, dormant}, figures {name: {current, prior}}, ratios, notIncluded[], reading; or readable:false with creditsRefunded

## Other responses

- `400`: Missing company
- `401`: Missing or wrong x-api-key
- `404`: No registered company found
- `503`: Companies House couldn't be read; nothing charged

---

[API](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis.md) · [All operations](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/meetkatalis/apis/katalis-uk-business-intelligence-apis/revisions/214b13088f95?raw)
