# UK Company Data: Profiles, Filings, Charges and Insolvency (`tan-solutions/uk-companies`) Actor

Get UK company profiles, status, SIC codes, registered office, accounts and confirmation dates, filing history, charges and insolvency from the official Companies House API with your own free key. Search by name or number. Pay per company; failures are free. Not affiliated with Companies House.

- **URL**: https://apify.com/tan-solutions/uk-companies.md
- **Developed by:** [Tan Solutions](https://apify.com/tan-solutions) (community)
- **Categories:** 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 $1.25 / 1,000 company delivereds

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

## UK Company Data: Profiles, Filings, Charges and Insolvency

Look up UK companies on the official public register and get clean, structured data: company profile and status,
SIC codes, registered office, accounts and confirmation statement dates, filing history, charges (mortgages) and
insolvency cases. Type in company numbers or company names. The data comes from the official Companies House REST
API, called with **your own free API key**.

Not affiliated with Companies House or the UK Government.

### Run it from the API or on a schedule

Get the companies back in one call (replace the two placeholders with your Apify token and your Companies House key):

```bash
curl -X POST "https://api.apify.com/v2/acts/tan-solutions~uk-companies/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "<YOUR_COMPANIES_HOUSE_KEY>", "companyNumbers": ["00445790", "00502851"], "searchQueries": ["marks and spencer"], "matchMode": "strict"}'
```

Check the same companies every Monday at 07:00 UK time with an Apify schedule (`dH3hVxsBkJGMryOgp` is this Actor's ID):

```bash
curl -X POST "https://api.apify.com/v2/schedules?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name": "uk-companies-weekly", "cronExpression": "0 7 * * 1", "timezone": "Europe/London", "isEnabled": true, "isExclusive": true,
       "actions": [{"type": "RUN_ACTOR", "actorId": "dH3hVxsBkJGMryOgp",
         "runInput": {"body": "{\"apiKey\": \"<YOUR_COMPANIES_HOUSE_KEY>\", \"companyNumbers\": [\"00445790\", \"00502851\"]}", "contentType": "application/json"}}]}'
```

In Apify Console the same is: **Schedules**, **Create new**, cron `0 7 * * 1`, add this Actor with your input.

### What it does

- **Company profile:** name, number, status (active, dissolved, liquidation and others), type, jurisdiction, date of
  creation and cessation, registered office address, SIC codes, previous names.
- **Accounts and confirmation statement:** last made up to, next due, overdue flags.
- **Filing history:** the most recent filings (date, type, category, description), up to 100 per company.
- **Charges:** mortgages and other secured charges, with their status.
- **Insolvency:** insolvency cases and their dates.
- **Officers and people with significant control (optional, off by default):** names and roles of a company's
  officers and PSCs, nested under the company you typed in.
- **Search by name:** type a company name and get the companies whose name contains every word you typed.

One row per company. You pay only for companies delivered; not-found, invalid, no-match and failed rows are free.

### Who it is for

- **Compliance and KYC teams:** confirm that a customer's company exists, is active and has the address they gave.
- **Finance and due diligence:** check accounts and filing dates, charges and insolvency history before a deal.
- **Procurement:** screen suppliers for dissolved, overdue or insolvent companies.
- **Developers:** feed clean JSON about UK companies into your own app, sheet or CRM through the Apify API.

### Quick start

1. Get your free key (below, about 2 minutes).
2. Paste it into the **Companies House API key** field.
3. Add company numbers, company names, or both, and click **Start**.

### How to get a key in 2 minutes

The key is free and needs no card.

1. Sign in (or create a free account) at the Companies House Developer Hub:
   developer.company-information.service.gov.uk.
2. Go to **Your applications** and click **Create an application**. Give it any name, and choose the **Live**
   environment.
3. Open the application and click **Create new key**. Choose the key type **REST**. If the form offers IP address or
   JavaScript domain restrictions, leave them empty: Apify runs come from changing IP addresses, so a key restricted
   to IPs is refused.
4. Copy the key and paste it into this Actor's **Companies House API key** field (`apiKey`). It is stored as a secret
   input: it is never logged or written to the dataset.

Without a key the run still succeeds, but it returns only one free row that says "API key required".

### Input

| Field | What it means | Default |
| --- | --- | --- |
| Companies House API key (`apiKey`) | Your own REST API key (see above). Secret. | none |
| Company numbers (`companyNumbers`) | Register numbers, e.g. `00445790`, `SC095000`, `OC300001`. Spaces and lowercase are fine; short numbers are padded to 8 characters. Never filtered. | none (`00445790` as an example) |
| Company names to search (`searchQueries`) | Company names; each one returns the matching companies. | none |
| Results per search (`maxResultsPerSearch`) | How many companies one name search asks the register for (1 to 100). | 5 |
| Name match (`matchMode`) | `strict`: keep a search result only when every word you typed is in the company name. Case and punctuation do not matter, and you never need to type LTD, LIMITED, PLC, LLP, THE or AND. Dropped results are not fetched and not charged. `all`: keep every company the register's search returns, including loose matches. | `strict` |
| Max companies per run (`maxCompanies`) | Stops after this many companies (1 to 10,000). | 500 |
| Filing history / Filings per company | Include the latest filings, and how many (1 to 100). | on, 25 |
| Charges (mortgages) | Include charges. | on |
| Insolvency cases | Include insolvency cases. | on |
| Officers (opt-in) | Include the company's officers. | off |
| People with significant control (opt-in) | Include the company's PSCs. | off |
| Birth month and year (second opt-in) | Add officers' and PSCs' month and year of birth. | off |
| Officers or PSCs per company | Cap per company (1 to 100). | 35 |
| Requests per second | 0.2 to 2. Companies House allows 600 requests per 5 minutes per key. | 2 |

Example input:

```json
{
  "apiKey": "<your key>",
  "companyNumbers": ["00445790", "SC095000"],
  "searchQueries": ["Greggs"],
  "matchMode": "strict",
  "maxResultsPerSearch": 3
}
```

### Output

One row per company. A real row from a test run on 13 Nov 2026, shortened (one filing shown, empty fields left out):

```json
{
  "input": "445790",
  "source": "companyNumber",
  "status": "ok",
  "companyNumber": "00445790",
  "companyName": "TESCO PLC",
  "companyStatus": "active",
  "companyType": "plc",
  "jurisdiction": "england-wales",
  "dateOfCreation": "1947-11-27",
  "registeredOfficeAddress": { "addressLine1": "Tesco House, Shire Park", "addressLine2": "Kestrel Way", "locality": "Welwyn Garden City", "postalCode": "AL7 1GA", "country": "United Kingdom" },
  "sicCodes": ["47110"],
  "accounts": { "accountingReferenceDate": "26-02", "lastMadeUpTo": "2026-02-28", "lastType": "group", "nextMadeUpTo": "2027-02-26", "nextDue": "2027-08-26", "overdue": false },
  "confirmationStatement": { "lastMadeUpTo": "2026-06-18", "nextMadeUpTo": "2027-06-18", "nextDue": "2027-07-02", "overdue": false },
  "hasCharges": false,
  "hasInsolvencyHistory": false,
  "previousCompanyNames": [{ "name": "TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY", "effectiveFrom": "1981-12-14", "ceasedOn": "1983-08-25" }],
  "filingHistory": [{ "date": "2026-11-09", "category": "officers", "type": "AP01", "description": "appoint-person-director-company-with-name-date", "pages": 2 }],
  "filingHistoryTotal": 8373,
  "charges": [],
  "chargesTotal": 0,
  "insolvencyCases": [],
  "registryUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790",
  "error": null
}
```

`status` is `ok`, `not_found`, `invalid_input`, `not_fetched` (stopped before this company, e.g. no key, a rate
limit or your spending limit) or `error`. Free rows carry an `error` with a code and a plain message, for example
`NO_MATCH` (the strict name match kept none of the register's results; the message suggests `matchMode: "all"`),
`NO_MATCHES` (the register found nothing), `NOT_FOUND`, `INVALID_INPUT` or `API_KEY_REQUIRED`. The run also writes a
`SUMMARY` record (companies, delivered, free rows, search hits, hits dropped by the strict match, requests) to the
key-value store.

### Pricing

Pay per event: you are charged once per company row with status `ok` (the profile plus the parts you selected:
officers, PSCs, filings, charges and insolvency).

| Event | FREE plan | BRONZE | SILVER | GOLD |
| --- | --- | --- | --- | --- |
| Company delivered (`company`), per 1,000 | $2.00 | $1.75 | $1.50 | $1.25 |

Free, never charged: `NO_MATCH`, `NO_MATCHES`, `API_KEY_REQUIRED`, invalid input and not-found rows, failed rows, and
companies a run did not fetch. Search results dropped by the strict name match are not fetched and not charged. A run
stopped by a rejected key charges nothing for the companies it did not fetch.

### Limits

- Speed: about 19 minutes per 1,000 companies with the default parts (profile and filing history; charges and
  insolvency only when a company has them), measured on 13 Nov 2026. The key's limit sets the pace.
- Companies House allows 600 requests per 5 minutes per key. One company takes about 2 to 4 requests (6 with
  officers and PSCs). When the window is used up, the Actor waits for it to reset and then goes on.
- Use one key per run at a time: two runs with the same key share the same limit.
- Up to 10,000 companies per run; name searches return at most 100 companies each.
- Data is as current as the public register, which can be late or wrong.

This Actor is for checking companies you already deal with. It is not a lead-list or people-finding tool: it has no
people search, and officer data is only available nested under a company you typed in.

### FAQ

**Why do I need my own key?** Companies House gives each user a free key, and the rate limit (600 requests per 5
minutes) belongs to that key. With your own key you control your access and your limit, and the data comes straight
from the official API.

**Why do I get fewer results than the register's website?** The register's search is loose: it also returns companies
whose names only look similar. By default (`matchMode: "strict"`) this Actor keeps only companies whose name contains
every word you typed, and you are not charged for the others. Set **Name match** to `all` to get every result the
register returns.

**My key is refused (HTTP 401 or 403).** A 401 means the key is wrong or incomplete, or it is a stream key: create a
REST key (step 3 above) and paste all of it. A 403 means the key is restricted to IP addresses or domains: create a
new REST key without restrictions.

**A company number returns `not_found`.** Check the number on the public register. Scottish numbers start with `SC`,
LLPs with `OC`, Northern Ireland with `NI` or `R0`.

**Is officer data personal data?** Yes. It is off by default. If you turn it on, see "Your responsibilities".

### Related tools by Tan Solutions

- [US Company Filings & Financials](https://apify.com/tan-solutions/company-filings): 10-K, 10-Q, 8-K filings and XBRL
  financial facts of US public companies from SEC EDGAR.
- [Domain Intelligence](https://apify.com/tan-solutions/domain-intel): DNS, WHOIS/RDAP, SSL and tech stack of a
  company's website domain.
- [URL to Markdown](https://apify.com/tan-solutions/url-to-markdown): turn any web page into clean Markdown for LLMs,
  RAG and AI agents.
- [Document to Markdown](https://apify.com/tan-solutions/document-to-markdown): PDF, Word and PowerPoint files (annual
  reports, filings) to Markdown.
- [SEO Audit](https://apify.com/tan-solutions/seo-audit): on-page SEO checker with PageSpeed for any website.

### More from Tan Solutions

- [UK companies tool page](https://www.tansolutions.org/tools/uk-companies/): details and examples for this Actor on our site.
- [Guide: Companies House API key, rate limit and fields](https://www.tansolutions.org/guides/companies-house-api-key-limits-fields/)
- [All Tan Solutions data tools](https://www.tansolutions.org/tools/)

### Your responsibilities

- You need your own Companies House API key and you are responsible for complying with the Companies House terms
  for its use.
- If you turn on officers, PSCs or birth month and year, you are the controller of that personal data. You must have
  a lawful basis under UK GDPR (or your own law) and use it only for the purpose you stated.
- No warranty: register data can be wrong or late. Liability is capped at the fees you paid in the last 12 months.
- Not affiliated with Companies House or the UK Government. No Crown logo or GOV.UK branding is used.
- Questions and issues are answered within 14 days through the Actor's Issues tab.

Made by Tan Solutions.

# Actor input Schema

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

Your own REST API key from the Companies House Developer Hub (free, about 2 minutes: see the README). Do not restrict the key to IP addresses: Apify runs use changing IPs.

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

UK company numbers, for example 00445790, SC005336 or OC301540. Short numbers are padded to 8 digits. Duplicates are removed.

## `searchQueries` (type: `array`):

Company names. Each search returns the best matching companies (see Results per search). Only companies are searched, never people.

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

How many matching companies each name search returns.

## `matchMode` (type: `string`):

Strict (default): keep a search result only when every word you typed is in the company name. Case and punctuation do not matter, and you never need to type LTD, LIMITED, PLC, LLP, THE or AND. Results that are dropped are not fetched and not charged. All: keep every company the register's search returns, including loose matches. Company numbers are never filtered.

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

Hard stop for the whole run (numbers plus search results). Companies over the limit are skipped and not charged.

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

Add the most recent filings (date, category, type, description, pages).

## `maxFilingsPerCompany` (type: `integer`):

How many of the most recent filings to return per company.

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

Add registered charges for companies that have any.

## `includeInsolvency` (type: `boolean`):

Add insolvency cases for companies with an insolvency history.

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

Add directors and secretaries, only for the company numbers you listed (never for name-search results): name, role, appointment and resignation dates, nationality, country of residence. Birth date and address are dropped. You are the controller of this personal data.

## `includePscs` (type: `boolean`):

Add PSCs, only for the company numbers you listed: name, kind, nature of control, notified and ceased dates, nationality, country of residence. Birth date and address are dropped. You are the controller of this personal data.

## `includeBirthMonthYear` (type: `boolean`):

Only with officers or PSCs on: add the month and year of birth the register shows. The day is never returned.

## `maxPeoplePerCompany` (type: `integer`):

How many officers and how many PSCs to return per company when they are turned on.

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

Companies House allows 600 requests per 5 minutes per key (2 per second). Lower it if you use the same key elsewhere at the same time.

## Actor input object example

```json
{
  "companyNumbers": [
    "00445790"
  ],
  "maxResultsPerSearch": 5,
  "matchMode": "strict",
  "maxCompanies": 500,
  "includeFilingHistory": true,
  "maxFilingsPerCompany": 25,
  "includeCharges": true,
  "includeInsolvency": true,
  "includeOfficers": false,
  "includePscs": false,
  "includeBirthMonthYear": false,
  "maxPeoplePerCompany": 35,
  "requestsPerSecond": 2
}
```

# Actor output Schema

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

One item per company: company profile, status, SIC codes, registered office, filing history, charges and insolvency (officers and PSCs when turned on).

# 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("tan-solutions/uk-companies").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("tan-solutions/uk-companies").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 tan-solutions/uk-companies --silent --output-dataset

```

## MCP server setup

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

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/dH3hVxsBkJGMryOgp/builds/vWID5mr8hZFmhtttf/openapi.json
