# Companies House UK Company Data - Directors, PSC & Financials (`rejoicing_shanty/uk-company-due-diligence`) Actor

UK Companies House scraper & due-diligence pack: company profile, directors/officers, PSC beneficial owners, charges, filing deadlines, risk flags and parsed iXBRL financials (turnover, profit, net assets). Bulk lookup by company number or name. For KYB, AML, supplier checks, lead enrichment.

- **URL**: https://apify.com/rejoicing_shanty/uk-company-due-diligence.md
- **Developed by:** [Bachir Djoukbala](https://apify.com/rejoicing_shanty) (community)
- **Categories:** Business, Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 company record (basic)s

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

## Companies House UK Company Data – Directors, PSC, Charges & Financials

**UK company check and due-diligence pack from Companies House, in bulk.** Give this Companies House scraper a list of UK company numbers or names and get one clean JSON record per company: **company profile and status**, **directors and officers**, **persons with significant control (PSC / beneficial owners)**, **charges (secured debt)**, accounts and confirmation-statement **filing deadlines**, ready-made **risk flags**, and **parsed iXBRL financials** (turnover, profit, net assets, cash, employees) from the accounts companies file.

A Companies House API alternative with no API key, no login and no proxies. Export UK company data to JSON, CSV or Excel, or call it from the Apify API, Make, Zapier, n8n or an AI agent.

**Popular uses:**

- **KYB / AML onboarding** – confirm a UK customer, merchant or partner is active and see who runs and controls it.
- **Supplier and vendor checks** – screen suppliers for overdue accounts, outstanding charges, insolvency history and negative net assets.
- **Lead enrichment** – add directors, SIC codes, company age, employees and net assets to UK B2B lead lists and CRMs.
- **Credit risk and investment screening** – pull multi-year balance-sheet trends for small and medium UK companies.

Works alongside our [France Company Data & KYB](https://apify.com/rejoicing_shanty/france-company-due-diligence) Actor for UK + France coverage.

### What it does

For each company number (or name) you provide, the Actor returns:

- **Profile** – name, status, company type, incorporation date, registered office, SIC codes, previous names
- **Filing deadlines** – accounts and confirmation statement due dates, last made-up-to dates
- **Officers** – directors and secretaries with role, appointment/resignation dates, nationality, country of residence, month/year of birth, identity-verification status
- **PSC / beneficial ownership** – persons with significant control plus any PSC statements or exemptions
- **Charges** – registered mortgages/secured lending, outstanding vs satisfied, lender names
- **Financials** – key balance sheet and P\&L figures for up to 10 fiscal years, parsed from iXBRL accounts in the Companies House Accounts Data Product, with links to the original filings
- **Risk flags** – active, accounts overdue, confirmation statement overdue, outstanding charges, insolvency history, PSC exemption/statement, negative net assets

Invalid or unknown company numbers return an error record instead of failing the whole run.

### Input example

```json
{
  "companyNumbers": ["00445790", "00003284", "SC123456"],
  "companyNames": ["Fenny Compton Water Company"],
  "includeFinancials": true,
  "accountsFilings": 2,
  "maxPeriods": 4,
  "includeOfficers": true,
  "activeOfficersOnly": true,
  "includePsc": true,
  "includeCharges": true
}
```

Company numbers are normalised automatically (`445790` → `00445790`). Supports England & Wales, Scotland (`SC`), Northern Ireland (`NI`) and LLPs (`OC`). Names are resolved via the Companies House search (first active match) – prefer numbers when you have them.

### Sample output

Real (trimmed) record from a test run:

```json
{
  "input": "00003284",
  "companyNumber": "00003284",
  "companyName": "FENNY COMPTON WATER COMPANY LIMITED(THE)",
  "status": "Active",
  "companyType": "Private limited Company",
  "incorporatedOn": "1866-10-13",
  "registeredOffice": "16 Field Gate Lane, Fenny Compton, Southam, England, CV47 2WB",
  "sicCodes": [
    "36000 - Water collection, treatment and supply"
  ],
  "accounts": {
    "nextMadeUpTo": "2026-12-31",
    "nextDue": "2027-09-30",
    "lastMadeUpTo": "2025-12-31"
  },
  "confirmationStatement": {
    "nextStatementDate": "2027-02-14",
    "nextDue": "2027-02-28",
    "lastMadeUpTo": "2026-02-14"
  },
  "officers": {
    "items": [
      {
        "name": "BIRKBECK, Hilary Rolf",
        "status": "Active",
        "address": "16 Field Gate Lane, Fenny Compton, Southam, England, CV47 2WB",
        "role": "Director",
        "birthMonth": "1954-05",
        "appointedOn": "2017-01-28",
        "nationality": "British",
        "countryOfResidence": "United Kingdom",
        "identityVerified": true
      }
    ],
    "summary": "22 officers / 21 resignations",
    "total": 22,
    "resigned": 21
  },
  "personsWithSignificantControl": {
    "items": [],
    "summary": "0 active persons with significant control / 1 active statement",
    "statements": [
      "Statement",
      "Active",
      "The company knows or has reasonable cause to believe that there is no registrable person or registrable relevant legal entity in relation to the company",
      "14 February 2017"
    ]
  },
  "charges": {
    "outstanding": 0,
    "items": []
  },
  "financials": {
    "source": "Companies House Accounts Data Product (iXBRL), OGL v3.0",
    "filings": [
      {
        "filedOn": "2026-09-04",
        "madeUpTo": "2025-12-31",
        "type": "Micro company accounts",
        "documentUrl": "https://find-and-update.company-information.service.gov.uk/company/00003284/filing-history/MzU0MjU4NzU4MGFkaXF6a2N4/document?format=pdf&download=0",
        "format": "iXBRL",
        "bulkFile": "Accounts_Bulk_Data-2026-09-05.zip",
        "dormant": "false",
        "currency": "GBP"
      }
    ],
    "periods": [
      {
        "periodEnd": "2025-12-31",
        "periodStart": "2025-01-01",
        "fixedAssets": 3474,
        "currentAssets": 12640,
        "currentLiabilities": 5050,
        "netCurrentAssets": 7782,
        "totalAssetsLessCurrentLiabilities": 11256,
        "netAssets": 10825,
        "employees": 2,
        "fromFiling": "2026-09-04"
      }
    ]
  },
  "flags": {
    "isActive": true,
    "accountsOverdue": false,
    "confirmationStatementOverdue": false,
    "hasOutstandingCharges": false,
    "hasInsolvencyHistory": false,
    "hasPscExemptionOrStatement": true,
    "negativeNetAssets": false
  },
  "registerUrl": "https://find-and-update.company-information.service.gov.uk/company/00003284",
  "retrievedAt": "2026-11-13T18:11:00Z"
}
```

### Use cases

- **KYB / AML checks** – verify a company is active, who runs it and who ultimately controls it before onboarding a customer or supplier
- **Lead enrichment** – add directors, SIC codes, size (employees, net assets) and age to UK B2B lead lists
- **Credit risk & supplier vetting** – spot overdue filings, outstanding charges, insolvency history and negative net assets in seconds
- **M\&A / investment screening** – pull multi-year balance sheet trends for small and medium UK companies in bulk
- **AI agents** – give LLM agents a structured UK company lookup tool through the [Apify MCP server](https://mcp.apify.com) or the Apify API

### Pricing

This Actor uses **pay-per-event** pricing – you only pay for companies successfully returned:

| Event | Price | When it is charged |
|---|---|---|
| Company record (basic) | **$0.003** | Company record without parsed financials |
| Company record with financials | **$0.012** | Company record with parsed iXBRL financial figures |

That is **$3 per 1,000 companies** for profile/officers/PSC/charges, or **$12 per 1,000** when financials are found. Companies that can't be found return a free error record. You can cap your spend per run with the "Max total charge" run option.

### Limitations

- **Financials come from machine-readable (iXBRL) accounts.** Large and listed groups (e.g. PLCs) usually file PDF accounts, so their record includes filing links but no parsed figures. Parsed financials therefore mainly cover **small and medium-sized companies** – the majority of the UK register.
- **Micro-entity and filleted small-company accounts** often contain only a balance sheet, so turnover and profit may be missing.
- Officer lists are capped by `maxOfficers` (default 50) and charges by `maxCharges` (default 25).
- Data is as current as the public Companies House register at run time.

### Data protection (UK GDPR)

Officer and PSC records contain **personal data** (names, month/year of birth, nationality, service addresses) that Companies House publishes on the public register. If you store or process this data you are a data controller under UK GDPR: make sure you have a lawful basis (e.g. legitimate interests for KYB/AML or credit checks), use it only for compatible purposes, keep it no longer than needed, and do not use it for unsolicited direct marketing where that is unlawful. Companies House does not publish full dates of birth or residential addresses, and neither does this Actor.

### Data source & licence

Contains public sector information from **Companies House** licensed under the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/). Financial figures come from the Companies House Accounts Data Product. This Actor is not affiliated with or endorsed by Companies House.

### FAQ

**Do I need a Companies House API key?** No.

**How fast is it?** A typical company takes a few seconds; requests to the register are rate-limited politely (configurable up to 2 req/s).

**Can I run it on a schedule?** Yes – use Apify Schedules to re-check a portfolio of companies daily or weekly and get alerts on new charges or overdue filings.

# Actor input Schema

## `companyNumbers` (type: `array`):

UK Companies House company numbers to look up, e.g. 00445790 (England & Wales), SC123456 (Scotland), NI012345, OC300001 (LLP). Leading zeros are added automatically if missing (445790 -> 00445790). Invalid formats return an error record instead of failing the run.

## `companyNames` (type: `array`):

Optional company names to resolve via the Companies House search. The first ACTIVE match is used (falls back to the top match). Prefer company numbers when you have them - names can be ambiguous.

## `includeFinancials` (type: `boolean`):

Parse key figures (turnover, profit, net assets, cash, employees etc.) from machine-readable iXBRL accounts in the Companies House Accounts Data Product. Companies that file PDF/paper accounts (common for large groups) return filing links but no figures.

## `accountsFilings` (type: `integer`):

How many of the most recent annual accounts filings to look at per company (each filing usually also contains the prior-year comparatives).

## `maxPeriods` (type: `integer`):

Maximum number of fiscal year-ends to return in financials.periods (newest first).

## `includeOfficers` (type: `boolean`):

Return directors and secretaries (name, role, appointed/resigned dates, nationality, occupation, country of residence).

## `activeOfficersOnly` (type: `boolean`):

If true, only currently serving officers are returned; if false, resigned officers are included too.

## `maxOfficers` (type: `integer`):

Maximum officers returned per company.

## `includePsc` (type: `boolean`):

Return persons with significant control (beneficial owners) and any PSC statements/exemptions.

## `includeCharges` (type: `boolean`):

Return registered charges (mortgages/secured debt) with outstanding/satisfied status and lender names.

## `maxCharges` (type: `integer`):

Maximum charges returned per company.

## `maxCompanies` (type: `integer`):

Hard cap on the number of companies processed in this run (after de-duplication).

## `maxConcurrency` (type: `integer`):

Companies processed in parallel (1-10). Requests to Companies House are rate limited regardless.

## `requestsPerSecond` (type: `number`):

Polite request rate to the Companies House register (capped at 2.0).

## Actor input object example

```json
{
  "companyNumbers": [
    "00445790"
  ],
  "includeFinancials": true,
  "accountsFilings": 2,
  "maxPeriods": 4,
  "includeOfficers": true,
  "activeOfficersOnly": true,
  "maxOfficers": 50,
  "includePsc": true,
  "includeCharges": true,
  "maxCharges": 25,
  "maxCompanies": 1000,
  "maxConcurrency": 3,
  "requestsPerSecond": 1.6
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (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 = {
    "companyNumbers": [
        "00445790"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("rejoicing_shanty/uk-company-due-diligence").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 = { "companyNumbers": ["00445790"] }

# Run the Actor and wait for it to finish
run = client.actor("rejoicing_shanty/uk-company-due-diligence").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 '{
  "companyNumbers": [
    "00445790"
  ]
}' |
apify call rejoicing_shanty/uk-company-due-diligence --silent --output-dataset

```

## MCP server setup

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

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/4xuPNm2xxJ8bEpV1k/builds/LjThpZaMTh8KOOpQs/openapi.json
