Is there an API for Companies House accounts?

Companies House publishes filed accounts as documents and in bulk files. This API reads the electronically filed ones (iXBRL) and returns standard figures as JSON, with a euro value, so you do not parse the filings yourself.

Which UK companies have accounts available?

Those that filed electronically, about three in four. Small and micro companies often file without a profit and loss account, so revenue and profit can be null; the quality block says so.

How many years do I get?

Three fiscal years by default, up to ten requested, but only the last three at launch exist for the UK.

Are the figures audited or checked?

They are as filed. The API checks that the balance sheet balances and reports it as balance_check; it does not audit the company.

UK company accounts API: the accounts a company filed, as JSON

Search a UK company by Companies House number, then read its filed annual accounts mapped to one standard chart, in GBP with the euro equivalent. Scale plan, with 10 calls a month on the lower plans.

What the call returns

GET /companies/{id}/financials?country=GB returns the annual accounts a UK company filed electronically with Companies House, mapped to one standard set of figures: revenue, gross profit, net profit, total assets, cash, equity and employees where the filing states them. Every figure carries the filing currency (GBP) and a euro value at the ECB annual average rate of the fiscal year, so a UK company can sit next to a Danish or a French one in the same table. The last three fiscal years are returned by default; years= takes 1 to 10.

# 1. the company id
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=GB&company_number=00445790' \
  -H 'Authorization: Bearer rk_live_...'

# 2. its filed accounts (use data[0].id from step 1)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/2000000000123/financials?country=GB&years=3' \
  -H 'Authorization: Bearer rk_live_...'

The answer is under data: a company block and a list of statements, most recent first. Each statement has fiscal_year, period_start, period_end, currency, the filing date, figures in the filing currency, figures_eur, the exchange rate used and a quality block that tells you what is missing and why.

Read the quality block before you trust a figure

Companies House does not publish a uniform set of accounts, and a small company may legally file very little. The quality block exists so that your code can tell the difference between zero and not filed:

has_profit_and_loss is false when the company filed a balance sheet only, which is common for small and micro-entities.
is_abridged, is_micro_entity and is_dormant flag the filing regime.
missing names a figure that is absent and the reason, for example revenue not reported.
balance_check says whether the balance sheet adds up.

What is covered, and what is not

Electronically filed accounts only (iXBRL): about three in four UK companies. Accounts filed on paper or as an image are not read.
Small and micro companies often file without a profit and loss account, so revenue and profit are null for them.
Three fiscal years at launch; older years are not backfilled.
Not credit scores. The call returns what was filed, not a rating or a forecast.
Group and parent accounts follow what the company filed; check statement_type.

Plan and cost

Financial statements are a Scale plan feature (EUR 99.99 a month, 50,000 credits). One company's statements cost 25 credits. Starter, Professional and free-trial keys can make 10 calls a month on this endpoint, enough to test it on real companies. The search that finds the id costs 1 credit, and an error response costs nothing.

The same endpoint serves France, Denmark, Sweden, Norway, Finland (digitally filed accounts), US SEC filers and listed companies in several other countries, with the same figures, so a UK supplier and its foreign parent can be read with one parser. Ireland is not available, because Irish filings are PDF images.

Using it with monitoring

A filed set of accounts is a snapshot. To be told when a UK company files something new, or changes status, subscribe it to Companies House monitoring: a new filing is a corporate event and arrives by webhook, and you then fetch the new accounts.

Starter is EUR 9.99/month (1,000 credits), Professional EUR 29.99 (10,000 credits), Scale EUR 99.99 (50,000 credits) and Enterprise is priced to order. A company record costs 1 credit; error responses cost nothing. The 14-day free trial includes 500 credits, needs a card, charges nothing during the trial and then continues as Starter unless you cancel. Prices are public and there is no sales call. See pricing.

Start your 14-day free trial · API documentation

The free trial lasts 14 days and includes 500 credits. A card is required and nothing is charged during the trial; it then continues as Starter (EUR 9.99/month) unless you cancel.

Frequently asked questions

Is there an API for Companies House accounts?: Companies House publishes filed accounts as documents and in bulk files. This API reads the electronically filed ones (iXBRL) and returns standard figures as JSON, with a euro value, so you do not parse the filings yourself.
Which UK companies have accounts available?: Those that filed electronically, about three in four. Small and micro companies often file without a profit and loss account, so revenue and profit can be null; the quality block says so.
What does it cost?: It is on the Scale plan (EUR 99.99 a month). A company's statements cost 25 credits. Starter, Professional and trial keys have 10 calls a month.
How many years do I get?: Three fiscal years by default, up to ten requested, but only the last three at launch exist for the UK.
Are the figures audited or checked?: They are as filed. The API checks that the balance sheet balances and reports it as balance_check; it does not audit the company.