# Companies House API: key, rate limit and fields

How to get a free Companies House API key, what the 600 requests per 5 minutes limit means, which endpoints return which fields, and how to get accounts data.

By Tan Solutions. Published 15 November 2026. Updated 15 November 2026.

## Short answer

The Companies House API is free. You register on the Companies House Developer Hub, create an application with an API key, and send that key with every request as the username of HTTP Basic authentication, with an empty password. Each application can make up to 600 requests in a five-minute window; past that you get HTTP 429 until the window resets ([Companies House, Rate limiting](https://developer-specs.company-information.service.gov.uk/guides/rateLimiting), read 15 November 2026).

> **Do this for a list:** [UK Company Data](https://www.tansolutions.org/tools/uk-companies/) returns one row per company with profile, filings, charges and insolvency, from USD 1.25 per 1,000 companies, with your own free key.

## 1. Get a key, step by step

1. **Create an account.** Companies House says you "need to register a user account" on the Developer Hub to explore and test the API ([Getting started](https://developer-specs.company-information.service.gov.uk/guides/gettingStarted), read 15 November 2026).
2. **Register an application.** Go to [Your applications](https://developer.company-information.service.gov.uk/manage-applications) and register the application "as an `API Key` application". That gives it a unique key ([Authorisation](https://developer-specs.company-information.service.gov.uk/guides/authorisation), read 15 November 2026).
3. **Pick a REST key, with no restrictions.** The endpoints in this guide are the REST API, so create a REST key, not a streaming key. In our own testing, a streaming key or an incomplete key gets HTTP 401, and a key restricted to certain IP addresses or domains gets HTTP 403 when called from elsewhere.
4. **Send it.** The API uses HTTP Basic authentication: "the Companies House API takes the username as the API key and ignores the password, so can be left blank" (Authorisation page). The official curl example:

```
curl -XGET -u my_api_key: https://api.company-information.service.gov.uk/company/00000006
```

Note the colon after the key: it tells curl the password is empty. In Python:

```python
import requests

key = "your-rest-api-key"
r = requests.get(
    "https://api.company-information.service.gov.uk/company/00445790",
    auth=(key, ""), timeout=30,
)
print(r.json()["company_name"])
```

## 2. The rate limit

The rule, in Companies House's own words: "You can make up to 600 requests within a five-minute period. If you exceed this limit, you will receive a `429 Too Many Requests` HTTP status code for each request made within the remainder of the five-minute window." The limit then resets to 600 (Rate limiting page, read 15 November 2026).

Three practical points:

- **600 per 5 minutes is 2 per second on average.** A burst faster than that only pulls the 429 forward.
- **The limit is per application key.** Two scripts sharing one key share one limit.
- **Do not try to get round it.** The same page says Companies House reserves "the right to ban without notice applications that regularly exceed or attempt to bypass the rate limits". If you need more, the page says to contact them.

How far 600 requests go depends on how many endpoints you call per company. A profile alone is one request; profile, filing history, charges and insolvency is four.

## 3. The endpoints and the fields you get

All calls go to `https://api.company-information.service.gov.uk` and take the company number, for example `00445790` for Tesco PLC. The [API reference](https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference) groups them as follows (read 15 November 2026).

| Endpoint | What it gives you |
|---|---|
| `/company/{company_number}` | Company profile: name, status, type, creation date, registered office, SIC codes, accounts and confirmation statement dates, previous names, whether it has charges or insolvency history |
| `/company/{company_number}/filing-history` | Every filing with date, category, type and description; filter with `category`, page with `items_per_page` and `start_index` |
| `/company/{company_number}/officers` | Directors and secretaries, with appointment dates |
| `/company/{company_number}/charges` | Mortgages and other secured charges, with status |
| `/company/{company_number}/insolvency` | Insolvency cases and their dates |
| `/company/{company_number}/persons-with-significant-control` | People and companies with significant control |
| `/search/companies` | Search by name |

The filing history parameters above are as documented on the [filing history list reference](https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference/filing-history/list); a company with no filing history returns 404.

Officer and PSC data names real people. If you collect it, you need a lawful basis under UK GDPR or your own law.

## 4. Accounts and iXBRL

The profile tells you when accounts were last made up to and when the next ones are due, but not the figures. The figures sit in the accounts document itself.

**By API.** Each accounts filing in the filing history links to a document. The Document API has two calls: `GET /document/{document_id}` for the metadata and `GET /document/{document_id}/content` for the file itself. The content call needs an `Accept` header naming the format you want; the formats on offer are listed in the metadata, and an unsupported one returns 406. A successful call answers with a 302 redirect to the file ([Document API reference](https://developer-specs.company-information.service.gov.uk/document-api/reference/document-location/fetch-a-document), read 15 November 2026). Accounts filed electronically are often available as inline XBRL (iXBRL), an HTML page with machine-readable tags; in our runs, some accounts were PDF only.

**In bulk.** Companies House publishes a free [Accounts Data Product](https://download.companieshouse.gov.uk/en_accountsdata.html): a ZIP file each morning, Tuesday to Saturday, with the accounts registered the previous day (Tuesday's covers Saturday to Monday). Each daily file stays up for 60 days, then the data moves to monthly files. Inside are iXBRL (.html), XBRL (.xml) or zipped iXBRL files named with the company number and balance sheet date. The page says the files are free and "not supported" (read 15 November 2026).

## 5. Bulk without code

If you want the register for every company rather than a list, start with the free downloads. The [Company data product](https://www.gov.uk/guidance/companies-house-data-products) is a monthly snapshot of live companies in CSV, with company type, registered office, SIC codes, status, accounts and confirmation statement dates and previous names. It is compiled to the end of the previous month and published within 5 working days (GOV.UK guidance, last updated 25 October 2022, read 15 November 2026).

If you have a list of companies and want fresh data, one row each, without writing code, that is what our two tools do.

**UK Company Data** ([tool page](https://www.tansolutions.org/tools/uk-companies/), [Apify Store](https://apify.com/tan-solutions/uk-companies)) reads the profile, filing history, charges and insolvency for each company number or name. A real input:

```json
{
  "apiKey": "your-rest-api-key",
  "companyNumbers": ["00445790"],
  "includeFilingHistory": true,
  "maxFilingsPerCompany": 25
}
```

A real row from a test run on 13 November 2026, shortened:

```json
{
  "input": "445790",
  "status": "ok",
  "companyNumber": "00445790",
  "companyName": "TESCO PLC",
  "companyStatus": "active",
  "companyType": "plc",
  "dateOfCreation": "1947-11-27",
  "sicCodes": ["47110"],
  "accounts": { "lastMadeUpTo": "2026-02-28", "nextDue": "2027-08-26", "overdue": false },
  "confirmationStatement": { "lastMadeUpTo": "2026-06-18", "nextDue": "2027-07-02", "overdue": false },
  "hasCharges": false,
  "hasInsolvencyHistory": false,
  "filingHistory": [{ "date": "2026-11-09", "category": "officers", "type": "AP01",
    "description": "appoint-person-director-company-with-name-date", "pages": 2 }],
  "filingHistoryTotal": 8373,
  "registryUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790"
}
```

It costs from USD 1.25 per 1,000 companies; companies not found, invalid numbers and failed rows are free. It keeps to the key's limit: with the default parts, 1,000 companies took about 19 minutes in our test on 13 November 2026, and when the window is used up the run waits and goes on. Officers and PSCs are off by default.

**UK Company Financials** ([tool page](https://www.tansolutions.org/tools/uk-company-financials/), [Apify Store](https://apify.com/tan-solutions/uk-company-financials)) reads the latest iXBRL accounts and returns the balance sheet: net assets, current assets, net current assets, creditors due within one year, cash and average employees. A real row from a cloud run on 14 November 2026, shortened:

```json
{
  "companyNumber": "06534961",
  "status": "ok",
  "accountsType": "total-exemption-full",
  "periodEnd": "2025-03-31",
  "filingDate": "2025-10-21",
  "currency": "GBP",
  "netAssets": 241481,
  "currentAssets": 431975,
  "creditorsWithinYear": 235753,
  "cash": 183117,
  "employees": 11,
  "documentFormat": "xhtml"
}
```

It costs from USD 5.00 per 1,000 companies. Companies whose latest accounts are PDF only come back as free `pdf-only` rows, with the link. It returns no turnover or profit, because most small companies file no profit and loss account. Give it a monitor name and schedule it, and later runs return only companies that filed new accounts, with the figures that moved.

## 6. Limits to know

- The register is only as current and correct as what companies file.
- The rate limit belongs to your key, whichever tool uses it.
- Large and listed companies often file PDF accounts, which have no machine-readable figures.
- Our tools: up to 10,000 companies per run; a name search returns at most 100. Not affiliated with Companies House.

## Sources

All read on 15 November 2026. The Companies House developer pages show no publication date.

1. Companies House, [Authorisation](https://developer-specs.company-information.service.gov.uk/guides/authorisation).
2. Companies House, [Rate limiting](https://developer-specs.company-information.service.gov.uk/guides/rateLimiting).
3. Companies House, [Getting started with the Companies House API](https://developer-specs.company-information.service.gov.uk/guides/gettingStarted).
4. Companies House, [Public Data API reference: filing history list](https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference/filing-history/list).
5. Companies House, [Document API reference: fetch a document](https://developer-specs.company-information.service.gov.uk/document-api/reference/document-location/fetch-a-document).
6. Companies House, [Free Accounts Data Product](https://download.companieshouse.gov.uk/en_accountsdata.html).
7. Companies House on GOV.UK, [Companies House data products](https://www.gov.uk/guidance/companies-house-data-products), last updated 25 October 2022.
8. Tan Solutions, [UK Company Data](https://apify.com/tan-solutions/uk-companies) and [UK Company Financials](https://apify.com/tan-solutions/uk-company-financials), test runs of 13 and 14 November 2026.

## Tools for this task

- [UK Company Data](https://www.tansolutions.org/tools/uk-companies/): Profiles, filings, charges and insolvency notices of UK companies, by company number. From USD 1.25 per 1,000 companies. Apify Store: https://apify.com/tan-solutions/uk-companies
- [UK Company Financials](https://www.tansolutions.org/tools/uk-company-financials/): Balance sheet figures of UK companies from their filed accounts, with alerts for new accounts. From USD 5.00 per 1,000 companies. Apify Store: https://apify.com/tan-solutions/uk-company-financials

Source: https://www.tansolutions.org/guides/companies-house-api-key-limits-fields/ · Tan Solutions
