# UK Company Financials: Companies House Accounts (`frenchdatalab/uk-company-financials`) Actor

UK companies that just filed accounts at Companies House: employees, net assets, cash, debts, turnover and profit when published, plus SIC sector, address and status. Filter by sector, postcode, town, headcount and net assets; get new filings on a schedule.

- **URL**: https://apify.com/frenchdatalab/uk-company-financials.md
- **Developed by:** [French Data lab](https://apify.com/frenchdatalab) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $6.00 / 1,000 company with accounts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## UK Company Financials: Companies House Accounts as Data

Every **UK company that has just filed its annual accounts at Companies House**, turned into clean data: **employees, net assets, cash, debts, turnover and profit** (when published), **previous-year figures**, plus **SIC sector, registered office address, status and incorporation date** from the official register.

Filter by **headcount, net assets, turnover, sector (SIC), postcode, town, incorporation date and keywords**, or schedule it to receive **every new set of accounts once**.

### What can you do with it?

- 🎯 **B2B leads by company size**: *"IT companies in Manchester with 10 to 49 employees"*, *"construction firms in Leeds with net assets over £500k"*.
- ⚠️ **Credit and risk monitoring**: companies with **negative net assets**, net current liabilities or falling cash, as soon as their accounts are filed.
- 📈 **Investment and M\&A sourcing**: growing headcount (`employees` vs `employeesPreviousYear`), strong balance sheets, young companies already above 50 staff.
- 🧾 **Accountants, lenders and insurers**: companies that just closed their year, with their figures and their next accounts due date.
- 🗺️ **Market research**: size distribution by sector and town (see the run summary).

### Why this Actor?

| | This Actor | Typical Companies House tools |
|---|---|---|
| Financial figures | ✅ employees, net assets, cash, debtors, creditors, turnover & profit when published, previous year | ❌ profile only, or one paid lookup per company |
| Bulk filters on size | ✅ min / max employees, net assets, turnover | ❌ |
| Sector, place, age | ✅ SIC prefixes, postcode areas / districts, towns, incorporation dates | ⚠️ |
| Clean output | ✅ one row per company, numbers as numbers, readable accounts type and standard | ⚠️ raw XBRL |
| Monitoring | ✅ only accounts not sent by a previous run | ❌ |
| API key | ✅ none needed (official bulk files) | ⚠️ |

### How it works

Companies House publishes every working day (Tuesday to Saturday) all the accounts filed electronically the day before (about 75% of the 2.2 million accounts filed each year), and every month a snapshot of all live companies. The Actor reads the daily files of the last *N* days (newest first), extracts the figures from each iXBRL document, and adds the register details. You get **one row per company** with its latest accounts of the period.

### Input

| Field | Description | Example |
|---|---|---|
| `filedInLastDays` | Accounts published in the last N days (1 to 60) | `7` |
| `minEmployees` / `maxEmployees` | Average headcount of the year | `10`, `49` |
| `minNetAssets` / `maxNetAssets` | Net assets in GBP (`-1` max = negative net assets) | `100000` |
| `minTurnover` | Turnover in GBP (only companies publishing it) | `1000000` |
| `sicCodes` | SIC 2007 prefixes | `["62", "6311"]` |
| `postcodes` | Area, district, sector or full postcode | `["M", "LS1", "EC1A"]` |
| `towns` | Post towns | `["Bristol"]` |
| `incorporatedFrom` / `incorporatedTo` | Incorporation date range | `"2021-01-01"` |
| `keywords` | Words in the name or principal activity | `["dental"]` |
| `includeDormant` | Include dormant companies (default: no) | `false` |
| `activeOnly` | Leave out companies being struck off, in liquidation or administration (default: yes) | `true` |
| `onlyNewSinceLastRun` | Monitoring mode | `true` |
| `maxResults` | Maximum companies | `1000` |

### Output

Real example (shortened):

```json
{
    "companyNumber": "06345415",
    "companyName": "LUXSON LTD",
    "accountsMadeUpTo": "2025-12-31",
    "publishedOn": "2026-10-01",
    "employees": 11,
    "employeesPreviousYear": 11,
    "netAssets": 2072334,
    "netAssetsPreviousYear": 1631669,
    "cash": 1946499,
    "cashPreviousYear": 1464428,
    "currentAssets": 2081691,
    "debtors": 135192,
    "creditorsDueWithinOneYear": 408014,
    "netCurrentAssets": 1673677,
    "currency": "GBP",
    "accountsType": "full",
    "accountingStandard": "FRS 102 section 1A (small)",
    "companyStatus": "Active",
    "incorporationDate": "2007-08-16",
    "sicCode": "62012",
    "sicCodes": ["62012 - Business and domestic software development", "62090 - Other information technology service activities"],
    "postTown": "MANCHESTER",
    "postcode": "M26 1NW",
    "nextAccountsDue": "2027-09-30",
    "companyUrl": "https://find-and-update.company-information.service.gov.uk/company/06345415"
}
```

Other fields: `grossProfit`, `operatingProfit`, `profitBeforeTax`, `profitAfterTaxPreviousYear`, `fixedAssets`, `currentAssets`, `debtors`, `creditorsDueWithinOneYear`, `creditorsDueAfterOneYear`, `netCurrentAssets`, `totalAssetsLessCurrentLiabilities`, `tradingStatus`, `dormant`, `groupAccounts`, `amended`, `incorporationDate`, `sicCodes` (with descriptions), `addressLine1`, `addressLine2`, `county`, `country`, `postcode`, `outstandingCharges`, `nextAccountsDue`, `filingHistoryUrl`.

The run summary (key-value store, `SUMMARY`) counts the companies by employee band, accounting standard, SIC code and town.

### Good to know

- **Figures are as filed** by each company, in the currency of the accounts (`currency`, almost always GBP). For group accounts (`groupAccounts: true`) the consolidated figures are given.
- **Employees** is the average number of persons employed during the year, directors included, as the law requires small companies to disclose it (about 85% of accounts).
- **Turnover and profit**: small companies may file balance-sheet-only ("filleted") accounts, so turnover is published by only a few % of companies, mostly medium and large ones. `minTurnover` keeps only those.
- **Coverage**: accounts filed electronically (about 75%); accounts filed on paper or as PDF images are not in the data. Daily files stay online 60 days, hence the 60-day maximum.
- **Register details** (status, address, SIC) come from the monthly snapshot of live companies.
- **No personal data**: names of directors, signatures and remuneration are never extracted.

### Pricing

Pay per company returned. Set a maximum cost per run and the Actor stops exactly there.

### Source & licence

Companies House **Accounts Data Product** and **Free Company Data Product**, public register information provided free of charge by Companies House. This Actor is independent and is not affiliated with or endorsed by Companies House.

# Actor input Schema

## `filedInLastDays` (type: `integer`):

Companies House publishes the accounts filed each working day (Tuesday to Saturday) and keeps them 60 days. 7 = about 50,000 to 150,000 sets of accounts.

## `minEmployees` (type: `integer`):

Average headcount of the year (directors included), published by about 85% of companies.

## `maxEmployees` (type: `integer`):

e.g. 49 for small businesses.

## `minNetAssets` (type: `integer`):

Shareholders' funds at the accounts date, e.g. 100000.

## `maxNetAssets` (type: `integer`):

Use -1 to list companies with negative net assets (liabilities above assets).

## `minTurnover` (type: `integer`):

Only a few % of small companies publish their turnover (most are exempt): this filter keeps those that do.

## `sicCodes` (type: `array`):

Prefixes of UK SIC 2007 codes, e.g. "62" (IT), "6201", "41" (construction), "56" (restaurants), "86" (health).

## `postcodes` (type: `array`):

Area ("M", "LS"), district ("M1", "EC1A"), sector ("M1 1") or full postcode.

## `towns` (type: `array`):

Post towns, e.g. "London", "Manchester", "Bristol".

## `incorporatedFrom` (type: `string`):

YYYY-MM-DD, e.g. young companies only.

## `incorporatedTo` (type: `string`):

YYYY-MM-DD, e.g. established companies only.

## `keywords` (type: `array`):

Words searched in the company name and in the principal activity described in the accounts, e.g. "software", "dental".

## `includeDormant` (type: `boolean`):

Dormant companies (no activity) are left out by default.

## `activeOnly` (type: `boolean`):

Leaves out companies being struck off, in liquidation or administration.

## `onlyNewSinceLastRun` (type: `boolean`):

Monitoring: schedule the Actor (e.g. daily or weekly) and receive each new set of accounts once.

## `maxResults` (type: `integer`):

Maximum number of companies returned (one row per company, its latest accounts).

## Actor input object example

```json
{
  "filedInLastDays": 7,
  "minEmployees": 10,
  "includeDormant": false,
  "activeOnly": true,
  "onlyNewSinceLastRun": false,
  "maxResults": 50
}
```

# Actor output Schema

## `companies` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "filedInLastDays": 7,
    "minEmployees": 10,
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("frenchdatalab/uk-company-financials").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "filedInLastDays": 7,
    "minEmployees": 10,
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("frenchdatalab/uk-company-financials").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "filedInLastDays": 7,
  "minEmployees": 10,
  "maxResults": 50
}' |
apify call frenchdatalab/uk-company-financials --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,frenchdatalab/uk-company-financials"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/T7fhQOTzKJCer2USA/builds/Q3nztavZoqaGSQpLq/openapi.json