# UK Companies House Company List & Lookup (bulk, cheap) (`gapforge/uk-company-list`) Actor

Filter UK companies by SIC code, postcode, town, status, type and dates, or look them up by number, from the official Companies House free monthly file. Company fields only: no director, officer or care-of names. Snapshot date on every row.

- **URL**: https://apify.com/gapforge/uk-company-list.md
- **Developed by:** [GapForge](https://apify.com/gapforge) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.35 / 1,000 company records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

### What does UK Company List do?

It lists UK companies from the Companies House Free Company Data Product, the monthly file that Companies House
publishes for free download. Filter by industry (SIC code or prefix), registered office postcode area, district or
post town, company status, company type, incorporation dates and overdue accounts or confirmation statements, or look
companies up by company number. You get one clean row per company, with the date of the monthly file in
`snapshotDate` on every row, ready to export as CSV, Excel or JSON.

Company fields only. The rows hold no director, officer or PSC names, and no care-of names.

Sales and marketing teams, market researchers, accountants and analysts use it to build lists of companies in a
sector and an area, or to check a list of company numbers against the register, without downloading and unpacking a
very large file themselves.

### Where does the data come from?

- The source is the Companies House Free Company Data Product on download.companieshouse.gov.uk
  (`BasicCompanyDataAsOneFile-YYYY-MM-01.zip`, or the same data in parts). It is free and needs no account.
- Companies House says the file is updated "within 5 working days of the previous month end" and describes it as
  covering "live companies on the public register".
- The snapshot covers live companies on the public register (including insolvency-style statuses, not Active only).
  It does not include dissolved companies; the November 2026 file had no Dissolved status.
- On reuse, Companies House says: "We impose no rules or requirements on how the information on the public register
  is used." The next sentence reads: "You are responsible for complying with any applicable data protection,
  copyright and other legislation and regulations." (GOV.UK guidance "Companies House data products".)
- Contains public sector information licensed under the Open Government Licence v3.0.
- The tool never uses the Companies House website search or the Companies House API.

### What data do you get?

One row per company:

- `companyNumber`, `companyName`
- `companyStatus`, `companyCategory`, `countryOfOrigin`: written as in the file
- `incorporationDate`, `dissolutionDate`: YYYY-MM-DD, empty where the file has none
- `registeredOfficePoBox`, `registeredOfficeLine1`, `registeredOfficeLine2`, `postTown`, `county`, `country`,
  `postCode`: the registered office, with its PO box where the file gives one
- `registeredOfficePoBox` is kept only when the file's value contains a digit and has no "C/O" or "CARE OF" wording;
  otherwise it is empty, because that free-text column sometimes holds a care-of entry or a name
- Care-of text ("C/O ..." or "CARE OF ...") inside a registered office line is removed and the rest of the address
  is kept: "C/O A FIRM 1 HIGH STREET" becomes "1 HIGH STREET", and a line that is only a care-of name is empty
- `sicCodes`: up to four industry codes, each split into `code` and `label` (the file's "62020 - Information
  technology consultancy activities" becomes code 62020 and its label)
- `accountsCategory`, `accountsRefDay`, `accountsRefMonth`, `accountsNextDueDate`, `accountsLastMadeUpDate`: the
  accounts, with the accounting reference day and month
- `confStmtNextDueDate`, `confStmtLastMadeUpDate`: the confirmation statement
- `returnsNextDueDate`, `returnsLastMadeUpDate`: the older annual return dates, where the file still has them
- `mortgagesTotal`, `mortgagesOutstanding`, `mortgagesSatisfied`, `mortgagesPartSatisfied`: the number of mortgage
  charges ever registered, outstanding, satisfied and partly satisfied
- `generalPartners`, `limitedPartners`: for limited partnerships, the number of general and limited partners (counts
  only, no names)
- `previousNames`: up to ten earlier company names, each with the date it changed (`name`, `changedOn`)
- `companyUri`: Companies House's own identifier URI for the company, as written in the file
- `companiesHouseUrl`: a link to the company's page on the Companies House service
- `snapshotDate`: the date of the monthly file the row comes from
- `type`: `company`, or `not_found` for a free row in a lookup, whose `message` says why

Every column of the monthly file is in the output except one. Left out on purpose: the care-of name of the
registered office, because it can hold a person's name. The monthly file has no director, officer or PSC names,
birth dates or contact details, so the tool has none to give.

### How to use it (step by step)

1. Open the Input tab. The prefilled run finds 20 IT consultancy companies (SIC 62020) in the Manchester M1 district.
2. Pick your **SIC codes or prefixes** and **Postcode areas or districts**. Add **Post towns**, a **Company status**,
   a **Company type**, incorporation dates or the overdue filters if you need them.
3. Set **Maximum results**.
4. Click **Start**. Results appear in the Output tab and can be exported as JSON, CSV or Excel.
5. To check companies by number, pick the **Lookup** mode and paste the numbers under **Company numbers**.
6. For a fresh list each month, add a schedule. A run in the second week of a month picks up that month's file.

The first run after a new monthly file is published downloads and splits the file before it answers. It builds a
\~0.65 GB snapshot in your account and can take around 55 minutes. That work is free. Keep the run timeout at the
default 2 hours or more for that run. Start one run first after a new monthly file and wait for it to finish: two
runs started together both build the snapshot, so each takes the full time. Later runs read only the parts of the
snapshot their filters need. In the same month they usually finish in seconds, not minutes.

### How much does it cost?

You pay per company delivered (the price line shows "Company record"):

- Free plan: $1.00 per 1,000 company records ($0.001 each)
- Starter plan: $0.60 per 1,000 company records
- Scale plan: $0.45 per 1,000 company records
- Business plan and higher: $0.35 per 1,000 company records

Apify also charges its small start fee of $0.00005 per run at the default 1,024 MB, one fee for each GB of memory.
Building the monthly snapshot is free, and so are the not-found rows of a lookup. A company is charged only after it is saved to your dataset.

Examples:

- 1,000 company records cost $1.00 on the Free plan, $0.60 on Starter, $0.45 on Scale and $0.35 on Business, plus the
  start fee.
- A monthly run that returns 250 companies costs about $0.25 on the Free plan.
- Apify's free plan includes $5 of monthly credit, enough for 4,999 company records in one run.

The tool stops cleanly at the maximum charge you set for the run and says so in the status message.

### Input example

```json
{
  "mode": "search",
  "sicCodes": ["62"],
  "postcodePrefixes":
    ["LS", "M1"],
  "companyStatus": ["Active"],
  "incorporatedFrom":
    "2020-01-01",
  "accountsOverdue": "any",
  "maxResults": 500
}
```

### Output example

```json
{
  "type": "company",
  "companyNumber": "SC000005",
  "companyName":
    "DELTA DATA LTD",
  "companyStatus": "Active",
  "companyCategory":
    "Private Limited Company",
  "incorporationDate":
    "2021-01-15",
  "registeredOfficePoBox":
    "PO BOX 5",
  "registeredOfficeLine1":
    "5 TEST PLACE",
  "postTown": "EDINBURGH",
  "country": "SCOTLAND",
  "postCode": "EH1 1AA",
  "accountsNextDueDate":
    "2027-10-31",
  "confStmtNextDueDate":
    "2027-01-28",
  "snapshotDate": "2026-11-01"
}
```

Shortened to fit a phone screen. A real row has every field listed under "What data do you get?", in that order,
including `sicCodes` and `companiesHouseUrl`.

### Integrations and API

Run it from the Apify API, the Apify CLI or the official clients for Python and JavaScript, on a schedule, or from
automation tools that connect to Apify (for example Make, n8n or Zapier). Webhooks can notify your system when a run
finishes. AI agents can call it through the Apify MCP server; the input and output schemas tell them what to send and
what comes back.

### FAQ

**Is it legal?** The tool reads the free monthly file that Companies House publishes for download, with no account
and no proxy, and names itself honestly in its user agent. Companies House states that it imposes no rules or
requirements on how the information on the public register is used. Contains public sector information licensed under
the Open Government Licence v3.0. The tool outputs company fields only. The Open Government Licence does not cover
personal data. You remain responsible for how you use the data, for example under UK data protection law if you
contact a company. This is not legal advice.

**Why no directors?** The monthly file holds company fields only. Director and PSC records are about people, so this
tool leaves them out. Companies House publishes them separately (the API, which needs an account, and a PSC bulk
file).

**How fresh is it?** It is a monthly snapshot, with the date on every row (`snapshotDate`). Companies House updates
the file within a few working days after each month ends, so by the end of a month a row can be about five weeks
old. Each run checks the download page for a newer file and builds it first when there is one.

**How do I cap spend?** Set **Maximum results**: you never pay for more companies than that in one search run. You can
also set a maximum charge for the run in the run options; the tool stops cleanly when it is reached.

**Is this affiliated with Companies House?** No. This tool is not affiliated with or endorsed by Companies House or
the UK government. It reads the file Companies House publishes for free reuse.

**Something looks wrong.** Open an Issue on this page with the run ID. We reply within one business day and fix confirmed bugs in the next build.

### Limits

- A monthly snapshot: a company formed or changed after the file's date shows up with the next monthly file.
- No director, officer, PSC or care-of names (see "What data do you get?").
- At most 50,000 companies per search run, and at most 1,000 numbers per lookup.
- A search with no SIC code and no postcode reads the whole snapshot, so it takes longer than a narrow one.
- The snapshot is kept in a named key-value store in your Apify account (`uk-company-list-snapshot`), so later runs
  reuse it. You can delete it at any time; the next run builds it again.
- 1,024 MB is the lowest memory setting the tool allows.
- Company names and registered offices appear as Companies House publishes them. A small company can be named after
  a person or registered at a home; the tool never links a company to a person.
- `companyStatus` and `companyCategory` are Companies House's own words; filter with the same spelling.

# Changelog

This Actor's version history is a separate document: https://apify.com/gapforge/uk-company-list/changelog.md

# Actor input Schema

## `mode` (type: `string`):

Search: companies that match the filters below. Lookup: the companies whose numbers you list under Lookup (the filters are not used). Refresh: only make sure the newest monthly snapshot is stored; it returns no rows and costs nothing per company.

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

Industry codes (UK SIC 2007), 1 to 5 digits. A prefix matches codes that start with it: 62 matches 62010 and 62020, never 16200 or 46620. A company matches when any of its codes matches.

## `postcodePrefixes` (type: `array`):

Registered office postcodes. An area (M, SW) matches only that area, so M does not match ME. A district (M1, SW1A) matches only that district, so M1 does not match M11. A sector (SW1A 1) or a full postcode also works.

## `postTowns` (type: `array`):

Registered office post towns, matched whole and without regard to upper or lower case (LEEDS = Leeds). A search with only towns and no SIC code or postcode reads the whole snapshot, so it takes longer.

## `companyStatus` (type: `array`):

Keep only these statuses, written as in the file (for example Active, or Active - Proposal to Strike off). Matched whole, without regard to case. Empty keeps every status.

## `companyCategory` (type: `array`):

Keep only these company types, written as in the file (for example Private Limited Company, or Limited Liability Partnership). Matched whole, without regard to case. Empty keeps every type.

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

Earliest incorporation date (YYYY-MM-DD). A company without an incorporation date is left out when a date is set.

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

Latest incorporation date (YYYY-MM-DD), included.

## `accountsOverdue` (type: `string`):

Overdue means the next accounts due date is before the snapshot date. Any keeps every company.

## `confirmationStatementOverdue` (type: `string`):

Overdue means the next confirmation statement due date is before the snapshot date. Any keeps every company.

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

Lookup mode only: up to 1,000 Companies House numbers. Leading zeros may be left out (6 = 00000006, SC1234 = SC001234). A number that is not in the monthly file gets a free not-found row.

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

Search mode: deliver at most this many companies. You pay per company delivered, so this also caps the cost.

## Actor input object example

```json
{
  "mode": "search",
  "sicCodes": [
    "62020"
  ],
  "postcodePrefixes": [
    "M1"
  ],
  "accountsOverdue": "any",
  "confirmationStatementOverdue": "any",
  "maxResults": 20
}
```

# Actor output Schema

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

Companies with number, name, status, postcode, SIC codes and incorporation date.

## `filings` (type: `string`):

Accounts and confirmation-statement dates of each company.

## `allFields` (type: `string`):

Every field of every row in the dataset, as defined by the dataset schema.

# 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 = {
    "mode": "search",
    "sicCodes": [
        "62020"
    ],
    "postcodePrefixes": [
        "M1"
    ],
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("gapforge/uk-company-list").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 = {
    "mode": "search",
    "sicCodes": ["62020"],
    "postcodePrefixes": ["M1"],
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("gapforge/uk-company-list").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 '{
  "mode": "search",
  "sicCodes": [
    "62020"
  ],
  "postcodePrefixes": [
    "M1"
  ],
  "maxResults": 20
}' |
apify call gapforge/uk-company-list --silent --output-dataset

```

## MCP server setup

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

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/52zESJbYZjQPUCgks/builds/XZapdzcHBl34u7GDG/openapi.json
