UK Company Financials: Balance Sheets and New-Accounts Alerts avatar

UK Company Financials: Balance Sheets and New-Accounts Alerts

Pricing

from $5.00 / 1,000 company delivereds

Go to Apify Store
UK Company Financials: Balance Sheets and New-Accounts Alerts

UK Company Financials: Balance Sheets and New-Accounts Alerts

UK company financials from Companies House accounts: net assets, current assets, creditors, cash and employees from the latest iXBRL filing, with your own free API key. Alerts when new accounts are filed. Not affiliated with Companies House.

Pricing

from $5.00 / 1,000 company delivereds

Rating

0.0

(0)

Developer

Tan Solutions

Tan Solutions

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

7 days ago

Last modified

Categories

Features

Limited permissions

Share

UK company financials from the latest accounts each company filed: net assets, current assets, creditors due within a year, cash and employees, read from the structured (iXBRL) accounts document, not guessed from a PDF. Give it company numbers, get one clean row per company. Turn on monitor mode and schedule it, and you get an alert row whenever one of your companies files new accounts, with the key figures that moved. The data comes from the official Companies House REST and Document APIs, called with your own free API key.

Not affiliated with Companies House or the UK Government.

Run it from the API or on a schedule

Get the balance sheets back in one call (replace the two placeholders with your Apify token and your Companies House key):

curl -X POST "https://api.apify.com/v2/acts/tan-solutions~uk-company-financials/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"apiKey": "<YOUR_COMPANIES_HOUSE_KEY>", "companyNumbers": ["06534961", "SC404279"], "monitorId": "my-watchlist"}'

Watch the same companies every Monday at 07:00 UK time with an Apify schedule. The first run stores a baseline; every later run returns only the companies that filed new accounts since the last run:

curl -X POST "https://api.apify.com/v2/schedules?token=<YOUR_API_TOKEN>" \
-H "Content-Type: application/json" \
-d '{"name": "uk-financials-weekly", "cronExpression": "0 7 * * 1", "timezone": "Europe/London", "isEnabled": true, "isExclusive": true,
"actions": [{"type": "RUN_ACTOR", "actorId": "3eNzAQGCUbJjcBrmW",
"runInput": {"body": "{\"apiKey\":\"<YOUR_COMPANIES_HOUSE_KEY>\",\"companyNumbers\":[\"06534961\",\"SC404279\"],\"monitorId\":\"my-watchlist\"}", "contentType": "application/json"}}]}'

In Apify Console the same is: Schedules, Create new, cron 0 7 * * 1, add this Actor with your input.

What it does

  • Balance sheet figures from Companies House accounts: net assets, current assets, net current assets, creditors due within one year, cash at bank and average number of employees, with the currency (GBP or the filing's own).
  • Accounts details: accounts type (micro-entity, total exemption full, small, full, group, dormant and others), period end, made-up date, filing date and a dormant flag.
  • Source links: a link to the accounts document and to the company's filing history on the public register, so every figure can be checked.
  • Monitor mode: give the list a name (monitorId) and schedule the run. You get one alert row when a company files new accounts, listing which key figures (net assets, current assets, creditors) moved by your threshold (10 % by default) or changed sign.
  • Honest about gaps: a company whose latest accounts were filed as PDF only gets a free pdf-only row with the link; a company that has not filed accounts yet gets a free no-accounts row.

It reads the balance sheet only. It does not return turnover or profit: most small UK companies file accounts without a profit and loss account, so those figures are not on the public record.

Who it is for

  • Credit control and trade credit: check a customer's net assets and creditors before you extend terms.
  • Suppliers and procurement: screen suppliers for negative net assets or a dormant company.
  • Lenders, brokers and due diligence: a quick balance sheet view of many UK companies at once.
  • Portfolio and account monitoring: a weekly alert when your watched companies file new accounts.
  • Developers: feed uk balance sheet data into your own app, sheet or CRM through the Apify API.

Quick start

  1. Get your free key (below, about 2 minutes).
  2. Paste it into the Companies House API key field.
  3. Add company numbers and click Start.

How to get a key in 2 minutes

The key is free and needs no card.

  1. Sign in (or create a free account) at the Companies House Developer Hub: developer.company-information.service.gov.uk.
  2. Go to Your applications and click Create an application. Give it any name, and choose the Live environment.
  3. Open the application and click Create new key. Choose the key type REST. If the form offers IP address or JavaScript domain restrictions, leave them empty: Apify runs come from changing IP addresses, so a key restricted to IPs is refused.
  4. Copy the key and paste it into this Actor's Companies House API key field (apiKey). It is stored as a secret input: it is never logged or written to the dataset.

Without a key the run still succeeds, but it returns only one free row that says "API key required".

Input

FieldWhat it meansDefault
Companies House API key (apiKey)Your own REST API key (see above). Secret.none
Company numbers (companyNumbers)Register numbers, e.g. 06534961, SC404279, OC301540. Spaces and lowercase are fine; short numbers are padded to 8 digits; duplicates are removed.06534961
Monitor name (monitorId)Turns on monitor mode: letters, digits and dashes, e.g. my-watchlist. The first run stores a baseline; later runs return only companies with new accounts. Use a different name for each list.none (off)
Alert threshold (%) (changeThresholdPercent)Monitor mode: a key figure counts as moved when it changes by at least this many percent, or changes sign.10
Also list unchanged companies (includeUnchanged)Monitor mode: also write a free row for each company with no new accounts.off
Max companies (maxCompanies)Stops after this many companies (1 to 10,000).1,000
Requests per second (requestsPerSecond)0.2 to 2. Companies House allows 600 requests per 5 minutes per key.2

Example input:

{
"apiKey": "<your key>",
"companyNumbers": ["06534961", "SC404279"],
"monitorId": "my-watchlist",
"changeThresholdPercent": 10
}

Output

One row per company. A real row from a cloud run on 14 Nov 2026 (the default company, accounts made up to 31 March 2025, shortened). The company name comes from the accounts as filed, so its letter case can differ from the register:

{
"input": "06534961",
"companyNumber": "06534961",
"companyName": "Manufacturing Capacity Solutions Limited",
"status": "ok",
"accountsType": "total-exemption-full",
"dormant": false,
"periodEnd": "2025-03-31",
"madeUpDate": "2025-03-31",
"filingDate": "2025-10-21",
"currency": "GBP",
"netAssets": 241481,
"currentAssets": 431975,
"netCurrentAssets": 196222,
"creditorsWithinYear": 235753,
"creditorsWithinYearDerived": false,
"employees": 11,
"cash": 183117,
"documentFormat": "xhtml",
"documentUrl": "https://find-and-update.company-information.service.gov.uk/company/06534961/filing-history/MzQ4NTc4MDc0M2FkaXF6a2N4/document?format=xhtml&download=0",
"monitor": null,
"alert": false,
"error": null
}

Fields:

  • status: ok (figures delivered), pdf-only (the latest accounts are a PDF only: no figures, the link is given), no-accounts (the company has not filed accounts yet) or failed (see error).
  • netAssets, currentAssets, netCurrentAssets, creditorsWithinYear, cash, employees: from the latest accounts; null when the company did not file that figure (cash and employees are often missing).
  • creditorsWithinYearDerived: true when the filing did not state creditors due within a year and the value was worked out as current assets minus net current assets.
  • dormant: true for dormant-company accounts.
  • monitor: baseline (first run of a monitor), new-accounts (alert row), unchanged (only with "Also list unchanged companies": a free row without figures) or null (monitor mode off). alertReasons and changes list the figures that moved, with the old and new value; previousPeriodEnd is the period of the accounts compared against.
  • error: null, or a code and message: INVALID_INPUT, NOT_FOUND, PDF_ONLY, NO_DOCUMENT, NO_FIGURES, DOCUMENT_TOO_LARGE, DOCUMENT_ERROR, PARSE_ERROR, HTTP_ERROR or API_KEY_REQUIRED.

The run also writes a SUMMARY record (companies, delivered, free rows, PDF-only, no accounts, alerts, requests) to the key-value store.

Pricing

Pay per event: you are charged once per company row with status ok that carries figures (including monitor baseline and alert rows). The price per 1,000 companies for your Apify plan is shown on the Pricing tab.

Free, never charged: pdf-only and no-accounts rows, failed rows (including NO_FIGURES, INVALID_INPUT, NOT_FOUND and API_KEY_REQUIRED), unchanged companies in monitor mode, and companies a run did not fetch. A run stopped by a rejected key charges nothing for the companies it did not fetch.

Limits

  • One company takes about 3 requests (filing history, document details, document). Companies House allows 600 requests per 5 minutes per key, so 1,000 companies take roughly half an hour. When the window is used up, the Actor waits for it to reset and then goes on.
  • Use one key per run at a time: two runs with the same key share the same limit.
  • Up to 10,000 companies per run; accounts documents over 16 MB are skipped with a free DOCUMENT_TOO_LARGE row.
  • Large and listed companies often file PDF accounts only; those come back as free pdf-only rows.
  • Data is as current as the public register, which can be late or wrong. Figures are as filed, in the filing's currency; they are not audited or adjusted by us.

FAQ

Why do I need my own key? Companies House gives each user a free key, and the rate limit (600 requests per 5 minutes) belongs to that key. With your own key you control your access and your limit, and the data comes straight from the official API.

Why are some companies pdf-only? Their latest accounts were filed as a scanned or PDF document, not in the structured iXBRL format, so there are no machine-readable figures. You get the link and you are not charged.

Why is there no turnover or profit? Most small and micro companies are allowed to file a balance sheet only. This Actor does not return turnover or profit, so you never pay for empty columns.

How does monitor mode know what changed? It keeps the last accounts it saw for each company in a named key-value store in your Apify account (uk-financials-monitor-<your monitor name>). Delete that store to start a fresh baseline.

My key is refused (HTTP 401 or 403). A 401 means the key is wrong or incomplete, or it is a stream key: create a REST key (step 3 above) and paste all of it. A 403 means the key is restricted to IP addresses or domains: create a new REST key without restrictions.

More from Tan Solutions

Data licence

Contains public sector information licensed under the Open Government Licence v3.0. The figures are taken from accounts filed at Companies House and are passed on as filed.

Your responsibilities

  • You need your own Companies House API key and you are responsible for complying with the Companies House terms for its use.
  • The output is company financial data. If you combine it with personal data, you are the controller of that personal data and must have a lawful basis under UK GDPR (or your own law).
  • No warranty: register data can be wrong or late. Liability is capped at the fees you paid in the last 12 months.
  • Not affiliated with Companies House or the UK Government. No Crown logo or GOV.UK branding is used.
  • Questions and issues are answered within 14 days through the Actor's Issues tab.

Made by Tan Solutions.