# Companies House API: UK company data

Type in UK company numbers or names and get one clean row per company from the official public register: status, registered office, SIC codes, accounts dates, recent filings, charges and insolvency cases. You need your own free Companies House API key.

**From USD 1.25 per 1,000 companies.** On the Apify Store since 14 November 2026. Checked 14 November 2026. Apify Store page: https://apify.com/tan-solutions/uk-companies

## What it does

UK Company Data reads the Companies House REST API with your own free API key. Give it register numbers, company names or both; every company comes back as one row in the same shape, ready for a sheet, a CRM or your own app.

- **Company profile.** Name, number, status (active, dissolved, in liquidation and others), type, creation date, registered office, SIC codes and previous names.
- **Accounts and confirmation statement.** Last made up to, next due, and whether either is overdue.
- **Filing history.** The latest filings with date, type and description: 25 per company by default, up to 100.
- **Charges and insolvency.** Mortgages and other secured charges with their status, and insolvency cases with their dates.
- **Search by name.** Keeps only companies whose name contains every word you typed; no need to type LTD or PLC.
- **Officers and people with significant control.** Off by default; when on, they come nested under the company you typed in.

## Who it is for

- Compliance and KYC teams who confirm that a customer's company exists, is active and has the address they gave.
- Finance and due diligence teams who check accounts dates, charges and insolvency history before a deal.
- Procurement teams who screen suppliers for dissolved, overdue or insolvent companies.

## What it costs

**From USD 1.25 per 1,000 companies.** You pay per result. The price depends on your Apify plan:

| Apify plan tier | Price per 1,000 companies |
|---|---|
| FREE | USD 2.00 |
| BRONZE | USD 1.75 |
| SILVER | USD 1.50 |
| GOLD | USD 1.25 |

Free, never charged: companies not found; invalid numbers; name searches with no match; failed rows; companies the run did not fetch; the row that asks for your API key. Apify also charges a small start event per run.

## Input

The fields you will most likely change:

| Field | What it does | Default |
|---|---|---|
| `apiKey` | Your Companies House REST API key, stored as a secret input. | empty |
| `companyNumbers` | Register numbers such as 00445790 or SC095000; short numbers are padded. | 00445790 |
| `searchQueries` | Company names to search. | empty |
| `matchMode` | strict keeps names with every word you typed; all keeps every result. | strict |
| `maxCompanies` | Stops after this many companies, up to 10,000. | 500 |
| `includeFilingHistory` | Latest filings; maxFilingsPerCompany sets how many. | on, 25 |
| `includeOfficers` | Officers; includePscs adds people with significant control. | off |
| `requestsPerSecond` | 0.2 to 2. | 2 |

A small input to start from:

```json
{
  "apiKey": "<YOUR_COMPANIES_HOUSE_KEY>",
  "companyNumbers": [
    "00445790",
    "00502851"
  ]
}
```

## Output

One row per company. A real row from a test run on 13 November 2026, shortened to one filing:

```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
}
```

The status is ok, not_found, invalid_input, not_fetched or error; rows that are not ok carry an error code and a plain message. Download as JSON, CSV or Excel, or read them through the API.

## How to run it

### In Apify Console, no code

1. Get a free REST API key from the Companies House Developer Hub (about 2 minutes, no card), with no IP or domain restrictions.
2. Paste it into "Companies House API key", add company numbers, names or both, and click Start. Without a key you get one free row that says a key is needed.
3. Open the Output tab: one row per company.

Start from the tool's page (https://apify.com/tan-solutions/uk-companies). You need an Apify account.

### From the API

One call runs the tool and returns the results. Replace `<YOUR_API_TOKEN>` with your token from Apify Console (Settings, API and Integrations). This tool reads the Companies House API with your own free API key, so put it in the input as "apiKey". Without a key the run returns one free row that says a key is needed.

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

### From an AI agent, through MCP

Apify's MCP server offers this tool alone to your MCP client at `https://mcp.apify.com?tools=tan-solutions/uk-companies`. The client signs in to Apify on first connect, or sends your token in an `Authorization: Bearer` header.

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=tan-solutions/uk-companies"
    }
  }
}
```

## Run it on a schedule

Check the companies you deal with every week and spot a change of status, an overdue filing, a new charge or an insolvency case early. In Apify Console: Schedules, Create new, cron `0 7 * * 1` (every Monday at 07:00 UTC), then add this tool with your input. Or as one API call (`dH3hVxsBkJGMryOgp` is this tool's Actor ID):

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

## Limits

- About 19 minutes per 1,000 companies with the default parts (measured 13 November 2026). Companies House allows 600 requests per 5 minutes per key and one company takes 2 to 4; when the window is used up, the run waits and goes on.
- Two runs with the same key share the same limit.
- Up to 10,000 companies per run; a name search returns at most 100.
- Data is as current as the public register, which can be late or wrong.
- No people search: officer data only comes nested under a company you typed in.

## Questions

### Why do I need my own key?

Companies House gives each user a free key, and the rate limit belongs to that key. Your own key means your own limit, and the data comes straight from the official API.

### Why fewer results than the register's own search?

The register's search also returns names that only look similar. The strict match keeps names with every word you typed, and you are not charged for the others. Set "Name match" to all for every result.

### My key is refused (HTTP 401 or 403).

A 401 means the key is wrong, incomplete or a stream key: create a REST key and paste all of it. A 403 means it is restricted to IPs or domains: create one without restrictions.

### Is officer data personal data?

Yes, so it is off by default. If you turn it on, you need a lawful basis under UK GDPR or your own law.

Not affiliated with Companies House or the UK Government. Built and run by Tan Solutions.

Source: https://www.tansolutions.org/tools/uk-companies/ · Tan Solutions
