# UK Companies House: New Company Leads, Officers and Filings (`dedicated_crest/uk-companies-house-leads`) Actor

Find new UK companies on the official Companies House register by SIC code, postcode and incorporation date. Registered address, accounts dates and optional officers and filings. No API key needed for company leads. $2 per 1,000.

- **URL**: https://apify.com/dedicated_crest/uk-companies-house-leads.md
- **Developed by:** [Ben Barazandeh](https://apify.com/dedicated_crest) (community)
- **Categories:** Lead generation, Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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: New Company Leads, Officers and Filings

Find new and existing UK companies on the official Companies House register. Filter by industry (SIC code), postcode or town, and incorporation date, and get one clean row per company with the registered office, company type, status, accounts dates and a link to the public company page. The default search uses the official [Free Company Data Product](https://download.companieshouse.gov.uk/en_output.html), a monthly snapshot of live companies, so it needs no login and no API key. Optionally paste your own free Companies House API key to add appointed officers and recent filing history.

**Price:** $0.002 per company saved (**$2 per 1,000**). No start fee on typical searches. You pay only for rows saved to the dataset, and companies removed by your filters are free. Officers and filings are included in that price when you turn them on. A **$0.10 full snapshot scan** fee is charged only when a query cannot use the precomputed last-13-months index (for example a search with no incorporation-date lower bound, or a date range older than that window).

**Try a run for free:** New Apify accounts get the [Free plan](https://apify.com/pricing), with $5 of platform usage credit each month and no credit card, so a test run is covered.

**Try it now:** the form is pre-filled with SIC prefix `62` (computer programming, consultancy and related activities), companies incorporated in the latest month of the snapshot, dormant companies excluded, and 20 results. Click **Start**. Typical last-month searches read a small precomputed index partition (the prefill reads one SIC slice, about 385 KB) and finish in a few seconds. The test run below took 3.2 seconds.

### Who uses it

1. **B2B sales and local lead lists.** Get newly incorporated companies in your industry and area. Example: SIC `62` or `432` (electrical installation), postcode area `M` (Manchester) or town `Bristol`, `incorporatedWithinDays: 31`, scheduled monthly when the new snapshot is published.
2. **Accountants, bookkeepers and formation follow-up.** Use `accountsCategory` and `accountsNextDueDate` to find new companies that have not filed accounts yet (`NO ACCOUNTS FILED`) and may need a first-year accountant.
3. **KYB and enrichment.** Paste a list of company numbers. With a free official API key you can add current officers (directors and secretaries) and recent filing history to each row.

### Real run results (21 Nov 2026, America/Los_Angeles)

Pre-filled input: `sicCodes: ["62"]`, `incorporatedWithinDays: 31`, `excludeDormant: true`, `maxItems: 20`. Run `4ZSv48aNW3rNnd8Ns` started at 8:49:05 AM PT and finished at 8:49:08 AM PT (**3.2 seconds**, compute **$0.00025**). It read one precomputed SIC-62 slice for October 2026 from the 1 Nov 2026 snapshot (compiled to 31 Oct 2026), scanned 6,850 indexed rows, found 6,841 matches, and saved the 20 most recently incorporated. All 20 were incorporated on 31 Oct 2026 and marked `NO ACCOUNTS FILED`. No snapshot-scan fee. First 8 rows:

| Company | Number | Town | Postcode | Primary SIC |
|---|---|---|---|---|
| BOOKEDTIK LTD | 17554142 | IPSWICH | IP1 3LD | 62012 - Business and domestic software development |
| MACRODESK LTD | 17554155 | LONDON | E8 2AB | 62012 - Business and domestic software development |
| LITTLE TREASURES INTERACTIVE LTD | 17554158 | COVENTRY | CV6 1DJ | 62011 - Ready-made interactive leisure and entertainment software development |
| EVOLGEN LIMITED | 17554160 | LONDON | W1W 5PF | 62090 - Other information technology service activities |
| ALL YOU CAN AI LTD | 17554170 | KINGTON | HR5 3DJ | 62012 - Business and domestic software development |
| \&KAIZEN LTD | 17554173 | BRENTFORD | TW8 0SL | 62090 - Other information technology service activities |
| MAYNARD PROJECTS LIMITED | 17554182 | LONDON | SW11 5RQ | 62090 - Other information technology service activities |
| KORA JETS HOLDINGS LTD | 17554183 | GREENFORD | UB6 0NE | 62012 - Business and domestic software development |

A company is kept if any of its up to four SIC codes starts with `62`, so a later row may list a different primary SIC and still be a valid match.

Second test, postcode area `M` (Manchester) with the same 31-day window, dormant companies excluded, `maxItems: 20`. Run `fiDX5Gxi5TqCWpbe3` started at 8:49:06 AM PT and finished at 8:49:11 AM PT (**4.8 seconds**, compute **$0.00029**). It read the October 2026 month partition (66,457 incorporations, about 4.5 MB gzipped), found 2,094 matches, and saved 20. First 5 rows:

| Company | Number | Town | Postcode | Primary SIC |
|---|---|---|---|---|
| DIRECT SPEC MOTORS LIMITED | 17554162 | MANCHESTER | M16 9HW | 45112 - Sale of used cars and light motor vehicles |
| DARBAZ LTD | 17554284 | MANCHESTER | M8 8ND | 47910 - Retail sale via mail order houses or via Internet |
| OPEOLUWA LTD | 17554288 | MANCHESTER | M30 0RF | 47810 - Retail sale via stalls and markets of food, beverages and tobacco products |
| MANCHESTER DOG STORE LIMITED | 17554392 | MANCHESTER | M41 9FG | 47910 - Retail sale via mail order houses or via Internet |
| LAEL’S CAFE LTD | 17554410 | MANCHESTER | M13 0ZJ | 56290 - Other food services |

### Input

| Field | What it does | Example |
|---|---|---|
| `sicCodes` | SIC code, prefix or word from the official SIC text. | `["62"]` or `["62012"]` or `["software"]` |
| `incorporatedWithinDays` | Keep companies incorporated in the last N days of the snapshot (measured from the snapshot's end date, not from today). | `31` |
| `incorporatedAfter` / `incorporatedBefore` | Optional date range (`YYYY-MM-DD`). | `2026-10-01` |
| `postcodes` | Full postcode, outward code (`M1`, `EC1A`) or area (`M`, `EC`, `SW`). Area `M` does not match `ME` or `ML`. | `["EC1", "W1"]` |
| `postTowns` | Registered office post town. | `["Manchester", "Salford"]` |
| `nameContains` | Text that must appear in the current or a previous name. | `HOLDINGS` |
| `companyNumbers` | Specific company numbers to look up. | `["14021076", "SC123456"]` |
| `companyStatus` | `active` (default), `active_or_strike_off`, or `any` status in the snapshot. | `active` |
| `companyTypes` | Optional types: private limited, LLP, PLC, CIC, nonprofit. | `["private_limited"]` |
| `excludeDormant` | Skip DORMANT accounts and SIC `99999`. Default on. | `true` |
| `companiesHouseApiKey` | Optional free official API key. Needed only for officers, filings, or a live number lookup. | (secret) |
| `includeOfficers` | Add appointed officers. Requires the API key. | `false` |
| `includeFilings` | Add recent filing history (not PDFs). Requires the API key. | `false` |
| `maxItems` | Stop after this many companies, keeping the most recently incorporated matches. | `20` |

Example input:

```json
{
  "sicCodes": ["62"],
  "incorporatedWithinDays": 31,
  "excludeDormant": true,
  "maxItems": 20
}
```

### Output

Each row is one company. Download as JSON, CSV, Excel or HTML, or send it to Google Sheets, HubSpot, Make, Zapier or n8n.

```json
{
  "companyName": "BOOKEDTIK LTD",
  "companyNumber": "17554142",
  "companyStatus": "Active",
  "companyCategory": "Private Limited Company",
  "incorporationDate": "2026-10-31",
  "postTown": "IPSWICH",
  "postcode": "IP1 3LD",
  "address": "14-16 CROWN STREET, IPSWICH, IP1 3LD, ENGLAND",
  "primarySic": "62012 - Business and domestic software development",
  "sicCodes": ["62012"],
  "accountsCategory": "NO ACCOUNTS FILED",
  "accountsNextDueDate": "2028-07-31",
  "companyUrl": "https://find-and-update.company-information.service.gov.uk/company/17554142",
  "source": "companies-house-free-data-product",
  "snapshotDate": "2026-11-01",
  "snapshotCompiledTo": "2026-10-31"
}
```

Other fields: `addressLine1`, `addressLine2`, `county`, `country`, `sicTexts`, `confirmationStatementNextDueDate`, `mortgageCharges`, `previousNames`, `officers`, `filings`, `scrapedAt`. Officers and filings stay empty unless you provide an API key and turn those options on.

### For AI agents

This Actor is `dedicated_crest/uk-companies-house-leads`. Call it through the Apify API, the JavaScript or Python client, or [Apify's MCP server](https://mcp.apify.com/?tools=dedicated_crest/uk-companies-house-leads). Send `sicCodes` (array of strings), and optionally `incorporatedWithinDays`, `postcodes`, `postTowns`, `companyNumbers` and `maxItems`. Each output row is one company with `companyName`, `companyNumber`, `incorporationDate`, `postTown`, `postcode`, `primarySic`, `accountsCategory` and `companyUrl`. If nothing matches, the run fails with a message that says which filter to loosen, so an agent never gets a silent empty result. Do not send a Companies House API key unless the caller asked for officers or filing history.

### Good to know

- **Where the data comes from.** Company rows come from Companies House's official Free Company Data Product, published under the [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/). Contains public sector information licensed under the Open Government Licence v3.0. The snapshot lists live companies and is compiled to the end of the previous month, then published within 5 working days of month end. It is not a same-day feed: a company incorporated this week will appear in the next snapshot.
- **Officers and filings.** Those fields are not in the free snapshot. They come from the official [Companies House Public Data API](https://developer-specs.company-information.service.gov.uk/) when you supply your own free API key. This Actor does not create a key for you.
- **Fails loudly.** If the snapshot is older than your date filter, or no company passes your filters, the run ends as FAILED with a clear reason instead of an empty dataset.
- **Speed.** Queries with `incorporatedWithinDays` (or another incorporation-date lower bound inside the last 13 months of the snapshot) read only the matching month partitions, and a still-smaller SIC slice when you set a numeric SIC prefix. The prefill run above took 3.2 seconds; the Manchester postcode-area search of the latest month took 4.8 seconds. Queries with no date lower bound, or dates older than the index window, fall back to a full download of the monthly snapshot (about 470 MB; an earlier full-register scan of 5,711,779 rows took about 26 minutes) and incur the $0.10 snapshot-scan fee.
- **Index freshness.** The last 13 months of incorporations are precomputed from the official monthly snapshot and refreshed after Companies House publishes a new file (usually within 5 working days of month end).
- **Scheduling.** Schedule monthly, a few days after month end, with `incorporatedWithinDays` set to 31 to get each new month of incorporations.

### Related tools

- [Website Contact Enrichment](https://apify.com/dedicated_crest/website-contact-enrichment): get emails, phones and social links from a company website once you have the domain.
- [FMCSA Trucking Scraper: New Carrier Leads, USDOT/MC Census](https://apify.com/dedicated_crest/fmcsa-trucking-carrier-leads): new US carrier and broker leads from the official USDOT census.

Questions or a missing field? Open an issue on the Issues tab and I'll fix it.

# Actor input Schema

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

Keep companies whose Standard Industrial Classification matches. Use a code or prefix (62 or 62012) or a word from the official SIC text (software). A company matches if any of its up to four SIC codes match. Leave empty for all industries.

## `incorporatedWithinDays` (type: `integer`):

Keep companies incorporated in the last N days of the snapshot. The free snapshot is compiled to the end of the previous month (for example the 1 Nov 2026 file goes through 31 Oct 2026), so this is measured from that date, not from today. Prefill 31 covers the latest full month in the snapshot.

## `incorporatedAfter` (type: `string`):

Optional start date (YYYY-MM-DD). Combined with 'Incorporated within days' when both are set (the later date wins). The snapshot has no companies incorporated after its compilation date.

## `incorporatedBefore` (type: `string`):

Optional end date (YYYY-MM-DD).

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

Registered office postcodes. A full postcode (M1 1AE) matches exactly, an outward code (M1, EC1A) matches that district, and letters only (M, EC, SW) match the postcode area. Area 'M' does not match ME or ML.

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

Registered office post towns, for example London, Manchester, Edinburgh. Case-insensitive; a company matches if the town equals one of these.

## `nameContains` (type: `string`):

Optional text that must appear in the current registered name or a previous name, for example HOLDINGS or CONSULTING.

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

Look up specific Companies House numbers, for example 14021076 or SC123456. When this is the only filter and you also provide an API key, the Actor uses the live API instead of the monthly snapshot.

## `companyStatus` (type: `string`):

The free snapshot lists live companies on the register, including some in liquidation or with a proposal to strike off. Default: Active only.

## `companyTypes` (type: `array`):

Optional company types. Leave empty for all types.

## `excludeDormant` (type: `boolean`):

Skip companies whose accounts category is DORMANT or whose SIC code is 99999 (Dormant Company). Turn off to include shells and dormant companies.

## `companiesHouseApiKey` (type: `string`):

Optional. A free key from https://developer.company-information.service.gov.uk/, used only if you turn on officers or filing history, or for a live lookup of specific company numbers. Leave empty to use the free monthly snapshot, which needs no key. The key is stored as a secret and is not written to the dataset.

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

Add appointed officers from the official Companies House API. Requires the API key above. Resigned officers are omitted unless you turn on the next option.

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

When including officers, also keep people who have resigned. Default: active officers only.

## `includeFilings` (type: `boolean`):

Add recent filing history (accounts, confirmation statements, incorporations) from the official API. Requires the API key above. Does not download PDFs.

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

How many of the most recent filings to save for each company when filing history is turned on.

## `maxItems` (type: `integer`):

Stop after saving this many companies, keeping the most recently incorporated matches. You pay only for saved companies. Maximum 10,000.

## Actor input object example

```json
{
  "sicCodes": [
    "62"
  ],
  "incorporatedWithinDays": 31,
  "companyStatus": "active",
  "excludeDormant": true,
  "includeOfficers": false,
  "includeResignedOfficers": false,
  "includeFilings": false,
  "maxFilings": 25,
  "maxItems": 20
}
```

# Actor output Schema

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

UK companies with number, status, address, SIC codes, incorporation date and optional officers.

# 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 = {
    "sicCodes": [
        "62"
    ],
    "incorporatedWithinDays": 31,
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("dedicated_crest/uk-companies-house-leads").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 = {
    "sicCodes": ["62"],
    "incorporatedWithinDays": 31,
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("dedicated_crest/uk-companies-house-leads").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 '{
  "sicCodes": [
    "62"
  ],
  "incorporatedWithinDays": 31,
  "maxItems": 20
}' |
apify call dedicated_crest/uk-companies-house-leads --silent --output-dataset

```

## MCP server setup

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

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/lLPIQW5u8guSSMki3/builds/E5MYuhB8D91Bo4WSR/openapi.json
