---
title: "Companies House API: free key, rate limit and endpoints — SONAR"
url: https://getsonar.report/guides/companies-house-api
description: "The Companies House API is free: register, create an API key and send it as the basic auth username. Limit: 600 requests per 5 minutes. Endpoints and bulk data."
language: en
dateModified: 2026-11-20
---

# Companies House API: how do I get a key, and what are the rate limits and endpoints?

**In short** (updated 2026-11-20): The Companies House Public Data API at api.company-information.service.gov.uk is free: you register a user account on the Companies House Developer Hub, create an application and an API key, and send the key as the username of HTTP basic authentication with an empty password. Each application can make up to 600 requests in a 5-minute period; above that every request gets a 429 Too Many Requests until the window resets, and Companies House asks you to contact it for a higher limit. The API returns live JSON for the company profile, officers, persons with significant control (PSCs), filing history, charges, insolvency and search, while filed documents come from the separate Document API, real-time changes from the streaming API, and whole-register copies from free bulk downloads.

1. Developer Hub Register a Companies House user account and sign in
2. Application Create a live or a sandbox (test) application
3. API key Create a key of type API key for that application
4. First call curl -u YOUR\_KEY: .../company/{number}
5. Stay in limits 600 requests per 5 minutes, back off on 429

From a Companies House account to your first API call.

## Main Companies House Public Data API endpoints

| Endpoint (GET) | What it returns |
| --- | --- |
| /search/companies?q= | Companies matching a search term, paged with items\_per\_page and start\_index |
| /advanced-search/companies | An advanced company search; /search/officers, /search/disqualified-officers and /dissolved-search/companies search other indexes |
| /company/{company\_number} | The company profile: name, number, type, status, date of creation, registered office, SIC codes, accounts and confirmation statement dates |
| /company/{company\_number}/officers | The list of the company’s officers, such as directors and secretaries |
| /officers/{officer\_id}/appointments | Every appointment held by one officer, across companies |
| /company/{company\_number}/persons-with-significant-control | The persons with significant control (individuals, corporate entities and legal persons); PSC statements are under /persons-with-significant-control-statements |
| /company/{company\_number}/filing-history | The filings made by the company, with a link to each document’s metadata in the Document API where one exists |
| /company/{company\_number}/charges | The charges (mortgages) registered against the company |
| /company/{company\_number}/insolvency | The company’s insolvency cases |
| /disqualified-officers/natural/{officer\_id} | The disqualifications of a disqualified director (a corporate version also exists) |

## Other Companies House data services for developers

| Service | Host or location | What it gives you |
| --- | --- | --- |
| Document API | document-api.company-information.service.gov.uk | A filed document’s metadata (/document/{document\_id}) and the document itself (/document/{document\_id}/content) |
| Streaming API | stream.companieshouse.gov.uk | Real-time changes pushed over a long-running connection: companies, filings, officers, PSCs, PSC statements, charges, insolvency cases, disqualified officers and exemptions; at most 2 concurrent connections per account |
| Free Company Data Product | download.companieshouse.gov.uk | A monthly CSV snapshot of basic data on live companies, published within 5 working days of month end |
| PSC snapshot | download.companieshouse.gov.uk | The full list of PSCs as JSON files, refreshed every morning before 10am GMT |
| Accounts data product | download.companieshouse.gov.uk | Electronically filed accounts in XBRL and inline XBRL, as daily and monthly ZIP files |
| Sandbox | api-sandbox.company-information.service.gov.uk | A test environment for filing and OAuth integrations; the streaming and document APIs do not run there |

## How to check it manually

1. Open the Companies House Developer Hub at developer.company-information.service.gov.uk and select Sign in / Register. You need a Companies House user account to use the API.
2. Create an application: give it a name and description and choose a live application (real register data) or a test application for the sandbox environment.
3. In the application, select Create new key, name the key and choose the client type API key. The other types are stream key, for the streaming API, and OAuth web client, for filing on behalf of a company.
4. Keep the key out of your source code and source tree, store it in an environment variable or configuration, restrict it to your IP address or domain, and regenerate it regularly, as the Companies House developer guidelines advise.
5. Make a first call with HTTP basic authentication, the key as the username and an empty password: curl -u YOUR\_API\_KEY: https://api.company-information.service.gov.uk/company/00000006 returns that company’s profile as JSON.
6. Search by name with /search/companies?q=, then read the profile, /officers, /persons-with-significant-control and /filing-history for the company number you found.
7. Count your requests: up to 600 per 5 minutes per application. On a 429 response, wait for the window to reset; Companies House may ban applications that regularly exceed or try to bypass the limit.
8. For the whole register, use the free bulk products (the monthly company data CSV, the daily PSC snapshot, the accounts data) and keep a copy current with the streaming API, reconnecting with the last timepoint you processed.

## What it tells you

- The live public register data for UK companies and other entities under the Companies Act 2006: company profile, status, registered office, SIC codes and filing deadlines.
- Officers and their appointments, persons with significant control and PSC statements, charges, insolvency cases, UK establishments, exemptions and disqualified officers.
- The filing history of a company and, through the Document API, the filed documents themselves.
- Real-time changes through the streaming API and full-register snapshots through the free bulk downloads.

## What it doesn’t tell you

- Whether a company, director or PSC is sanctioned or a politically exposed person (PEP): the API holds register data only, so screening is a separate step.
- Adverse media or offshore leaks data.
- Filed documents in the same call: the filing history links to the Document API, a separate service at its own host.

## How SONAR automates it

The Companies House API is the right tool if you want raw UK register data in your own app. If you need the screening around it, SONAR has its own KYB API (/v1) and an MCP server, getsonar-mcp, for Claude Desktop, Claude Code, Cursor, Windsurf and other MCP clients.

One full report call (kyb\_run\_submit in the MCP server) returns a screened KYB report as JSON: the registry record, the officers, the owners where the register publishes them, 8 sanctions lists, the OpenSanctions PEP dataset, the ICIJ Offshore Leaks Database and adverse media, with a source for every finding. For a UK company, SONAR reads the record and officers from Companies House.

Pricing is per call from a prepaid balance: €0.01 per company found by a register lookup or officers call (your first 100 found are free), €0.50 per findings or adverse media call and €6 per full KYB report; your first findings or report call is free.

SONAR is a due-diligence tool for checking vendors, partners, resellers and suppliers. It compiles public-record data. It is not a regulated AML / KYC provider, does not verify identity documents, and is not legal advice.

Your first report is free, no card needed; every report includes a receipt for each source it used.

[Read the methodology](https://getsonar.report/methodology) · [Screen a company free](https://getsonar.report/login?mode=signup)

## Frequently asked questions

### Is the Companies House API free?

Yes. Companies House makes the public data it holds on companies available free of charge, including through its API. You need a free Companies House user account and an API key, and the bulk company data, PSC snapshot and accounts data products are free downloads too.

### What is the Companies House API rate limit?

Up to 600 requests within a 5-minute period per application. If you go over, each further request in that window gets a 429 Too Many Requests status code, and the limit resets to 600 at the end of the period. If your application needs more, contact Companies House; applications that regularly exceed or try to bypass the limit can be banned without notice.

### How do I get a Companies House API key?

Register or sign in on the Developer Hub at developer.company-information.service.gov.uk, create an application (live or sandbox), then select Create new key and choose the client type API key. Send the key as the username of HTTP basic authentication and leave the password blank.

### Can I get officers, PSCs and documents from the Companies House API?

Officers and persons with significant control, yes: GET /company/{company\_number}/officers and /company/{company\_number}/persons-with-significant-control. Documents come from the separate Document API at document-api.company-information.service.gov.uk: the filing history gives each document’s metadata link, and /document/{document\_id}/content fetches the file.

### Does the Companies House API include sanctions or PEP screening?

No. It returns what is on the UK public register, such as companies, officers, PSCs, filings, charges and insolvency. To check the company and its people against sanctions lists, PEP data and adverse media, you need a separate screening step or a KYB service.

## Official sources

- [Companies House Developer Hub: API overview](https://developer.company-information.service.gov.uk/)
- [Companies House Developer Hub: get started](https://developer.company-information.service.gov.uk/get-started)
- [Companies House Developer Hub: how to create an application](https://developer.company-information.service.gov.uk/how-to-create-an-application)
- [Companies House Developer Hub: API authentication](https://developer.company-information.service.gov.uk/authentication)
- [Companies House Developer Hub: developer guidelines (rate limits, key security)](https://developer.company-information.service.gov.uk/developer-guidelines)
- [Companies House Developer Hub: API testing and the sandbox](https://developer.company-information.service.gov.uk/api-testing)
- [Companies House API: rate limiting](https://developer-specs.company-information.service.gov.uk/guides/rateLimiting)
- [Companies House Public Data API reference](https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference)
- [Companies House Document API reference](https://developer-specs.company-information.service.gov.uk/document-api/reference)
- [Companies House streaming API: getting started](https://developer-specs.company-information.service.gov.uk/streaming-api/guides/overview)
- [Companies House: Streaming API authentication (stream.companieshouse.gov.uk)](https://developer-specs.company-information.service.gov.uk/streaming-api/guides/authentication)
- [Companies House streaming API reference](https://developer-specs.company-information.service.gov.uk/streaming-api/reference)
- [GOV.UK: Companies House data products](https://www.gov.uk/guidance/companies-house-data-products)
- [GOV.UK: searching the Companies House register](https://www.gov.uk/guidance/searching-the-companies-house-register)
- [Companies House: Free Company Data Product](https://download.companieshouse.gov.uk/en_output.html)
- [Companies House: PSC snapshot](https://download.companieshouse.gov.uk/en_pscdata.html)

## Run these checks on a company you’re about to sign

Registry record, owners, sanctions, PEP, ICIJ Offshore Leaks and adverse media in one report, with a receipt for every source. 1 free report, no card.

[Screen a company free](https://getsonar.report/login?mode=signup)

Source page: https://getsonar.report/guides/companies-house-api
