# UK Companies House - Company Data & Officers (`zhucl1006/uk-companies-house-company-data`) Actor

Get UK company data from the official Companies House register: profile, status, SIC codes, registered address, accounts due dates, officers and filing history. Search by name or company number. Use your free API key. $3 per 1,000 companies.

- **URL**: https://apify.com/zhucl1006/uk-companies-house-company-data.md
- **Developed by:** [leo zhu](https://apify.com/zhucl1006) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 companies

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 Companies House - Company Data & Officers

Pull **UK company data straight from the official Companies House register** into a spreadsheet: company name and number, **status** (active, dissolved, liquidation...), **company type, incorporation date, SIC codes, registered office address**, previous names, **accounts and confirmation statement due dates** (overdue flags), charges / insolvency flags, plus optional **officers (directors)** and **filing history**. Search by **company name** or look up **company numbers** in bulk.

Great for KYC / supplier checks, B2B lead lists, CRM enrichment, due-diligence and accountancy prospecting (find companies with accounts due soon).

### How to use it

1. Get your **free Companies House API key** (2 minutes): go to [developer.company-information.service.gov.uk](https://developer.company-information.service.gov.uk), register, **Create an application** (choose *Live*), then **Create new key** > *REST*. Paste it into **Companies House API key** - it's a secret input, never shown in logs or output.
2. Add **company numbers** and/or **company names** to search.
3. Optionally switch on **officers** and **filing history**. Start, then export CSV / Excel / JSON.

**No key yet?** The Actor still works in a limited mode: up to 20 companies per run, profile fields only (no officers / filings), read from the public GOV.UK company pages at 1 request per second. Add a key for full speed and all fields.

### Output example

```json
{"companyNumber": "00445790", "companyName": "TESCO PLC", "status": "ok", "companyStatus": "active", "companyType": "plc",
 "incorporatedOn": "1947-11-27", "sicCodes": ["47110"], "registeredOfficeAddress": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
 "accountsNextDue": "2027-08-24", "confirmationStatementNextDue": "2027-06-15", "officersCount": 14,
 "officers": [{"name": "SMITH, Jane", "role": "director", "appointedOn": "2020-01-01", "nationality": "British", "birthMonthYear": "1970-05"}],
 "companiesHouseUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790"}
```

### Pricing (pay per event)

| Companies | Cost |
|---|---|
| 100 | $0.30 |
| 1,000 | $3.00 |
| 10,000 | $30.00 |

Plus $0.00005 per run start. Officers and filing history are **included** at no extra cost. **Free:** invalid numbers, companies not found, searches with no results, errors. The Apify Free plan's $5 monthly credit covers about 1,600 companies. If your **Maximum cost per run** is reached, the Actor stops cleanly and lists the remaining numbers as `NOT_PROCESSED_COMPANIES` in the key-value store.

### Speed and limits

The official API allows 600 requests per 5 minutes per key. The Actor stays under that (about 2 requests/s) and waits on `429` - it never tries to bypass the limit. One company = 1 request (+1 for officers, +1 for filings), so about 1,000 profiles in under 10 minutes.

### Data protection (GDPR / UK GDPR)

Officer data is **personal data** even though Companies House publishes it. The Actor minimises it: **no home or correspondence addresses**, birth date as month/year only (as published), current officers only unless you ask for resigned ones. You are the controller of the data you collect: have a lawful basis (e.g. legitimate interest for B2B checks), respect objections and PECR rules for marketing, and don't keep data longer than needed. Data: Companies House, Open Government Licence v3.0.

Not affiliated with Companies House.

### Feedback

Found this useful? Please leave a review. Problem with a run? Open an issue or use **Share run with developer** - we fix reports quickly.

# Actor input Schema

## `apiKey` (type: `string`):

Your own free REST API key from developer.company-information.service.gov.uk (Register > Create application > Live > Create new key > REST). Without a key the Actor runs a limited mode: max 20 companies, profile fields only.

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

8-character Companies House numbers, e.g. 00445790, SC123456, OC301540. Short numbers are zero-padded.

## `searchNames` (type: `array`):

Each name is searched on Companies House; the top results are fetched.

## `maxResultsPerSearch` (type: `integer`):

Companies fetched per search name (each is one charged company).

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

Directors and secretaries: name, role, appointed/resigned dates, nationality, occupation, country of residence, birth month/year. No home addresses.

## `includeResignedOfficers` (type: `boolean`):

By default only current officers are returned.

## `includeFilingHistory` (type: `boolean`):

Latest filings (date, type, category, description).

## `maxFilings` (type: `integer`):

Latest N filings.

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

Skip dissolved / liquidated companies (they are not charged).

## Actor input object example

```json
{
  "companyNumbers": [
    "00445790"
  ],
  "searchNames": [
    "Monzo Bank",
    "Octopus Energy"
  ],
  "maxResultsPerSearch": 2,
  "includeOfficers": false,
  "includeResignedOfficers": false,
  "includeFilingHistory": false,
  "maxFilings": 10,
  "activeOnly": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `runSummary` (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"
    ],
    "searchNames": [
        "Monzo Bank",
        "Octopus Energy"
    ],
    "maxResultsPerSearch": 2
};

// Run the Actor and wait for it to finish
const run = await client.actor("zhucl1006/uk-companies-house-company-data").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"],
    "searchNames": [
        "Monzo Bank",
        "Octopus Energy",
    ],
    "maxResultsPerSearch": 2,
}

# Run the Actor and wait for it to finish
run = client.actor("zhucl1006/uk-companies-house-company-data").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"
  ],
  "searchNames": [
    "Monzo Bank",
    "Octopus Energy"
  ],
  "maxResultsPerSearch": 2
}' |
apify call zhucl1006/uk-companies-house-company-data --silent --output-dataset

```

## MCP server setup

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

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/Cyegrn2LtC916LCFo/builds/XbqCjtKuwTYmrbFwa/openapi.json