Skip to main content

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

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.

Last reviewed:

  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/companiesAn 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}/officersThe list of the company’s officers, such as directors and secretaries
/officers/{officer_id}/appointmentsEvery appointment held by one officer, across companies
/company/{company_number}/persons-with-significant-controlThe persons with significant control (individuals, corporate entities and legal persons); PSC statements are under /persons-with-significant-control-statements
/company/{company_number}/filing-historyThe filings made by the company, with a link to each document’s metadata in the Document API where one exists
/company/{company_number}/chargesThe charges (mortgages) registered against the company
/company/{company_number}/insolvencyThe 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

ServiceHost or locationWhat it gives you
Document APIdocument-api.company-information.service.gov.ukA filed document’s metadata (/document/{document_id}) and the document itself (/document/{document_id}/content)
Streaming APIstream.companieshouse.gov.ukReal-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 Productdownload.companieshouse.gov.ukA monthly CSV snapshot of basic data on live companies, published within 5 working days of month end
PSC snapshotdownload.companieshouse.gov.ukThe full list of PSCs as JSON files, refreshed every morning before 10am GMT
Accounts data productdownload.companieshouse.gov.ukElectronically filed accounts in XBRL and inline XBRL, as daily and monthly ZIP files
Sandboxapi-sandbox.company-information.service.gov.ukA 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 · Screen a company free

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

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