The Companies House API is the official way for software to read the UK's register of companies, one company at a time. It's free, it needs a key, and it answers in JSON. This guide takes you from no account to your first search and company profile, with cURL, Python and JavaScript, and covers the rate limit and the errors you'll meet first.
The short answer: register on the Companies House developer site (developer.company-information.service.gov.uk), create an application and an API key, then call https://api.company-information.service.gov.uk with the key as the username of HTTP Basic authentication and an empty password. Search with GET /search/companies?q=…, read a company with GET /company/{company_number}, and stay under 600 requests per five minutes.
What you'll learn
- What the Companies House API is, and what it isn't
- How to get an API key and authenticate
- How to search for a company and page through results
- What the company profile returns, and which fields to read first
- The rate limit, the first errors you'll meet, and when to use the free monthly file instead
What is the Companies House API?
Companies House keeps the register of companies for the whole United Kingdom. Its Public Data API, in Companies House's words, "lets you retrieve information about limited companies (and other companies that fall within the Companies Act 2006)". It's read-only: you look up what the register holds; you don't file anything through it.
The developer site, developer.company-information.service.gov.uk, is where you register, create keys and read the API reference. The API itself answers at https://api.company-information.service.gov.uk. For people rather than software, the same register is on Companies House's free search website: see how to use the Companies House search.
How do you get a Companies House API key?
Companies House asks you to "register a user account", then create an application to get credentials. The API then needs those credentials "with each request, which is sent as an API key, stream key or OAuth access token". To read public data, an API key is what you need.
Keep the key out of your code: put it in an environment variable, here CH_API_KEY.
How does authentication work?
The API uses HTTP Basic Authentication in a simple way: in Companies House's words, it "takes the username as the API key and ignores the password, so can be left blank". A request without a valid key gets 401 Unauthorized.
With cURL (-u sends the key as the username, with an empty password after the colon):
curl -u "$CH_API_KEY:" https://api.company-information.service.gov.uk/company/00000006
With Python (requests):
import os, requests
key = os.environ["CH_API_KEY"]
r = requests.get("https://api.company-information.service.gov.uk/company/00000006",
auth=(key, ""), timeout=20)
r.raise_for_status()
print(r.json()["company_name"], r.json()["company_status"])
With JavaScript (fetch), building the Basic header yourself:
const key = process.env.CH_API_KEY;
const auth = "Basic " + Buffer.from(`${key}:`).toString("base64");
const res = await fetch("https://api.company-information.service.gov.uk/company/00000006", {
headers: { Authorization: auth },
});
const profile = await res.json();
console.log(profile.company_name, profile.company_status);
The company number 00000006 is the one Companies House uses in its own authentication example.
How do you search for a company?
When you have a name rather than a number, use the search endpoint, GET /search/companies. Its parameters, from the API reference:
q: the term being searched for (required).items_per_page: the number of results per page.start_index: the index of the first result to return, for paging.restrictions: options that narrow the results, separated by spaces.
curl -u "$CH_API_KEY:" "https://api.company-information.service.gov.uk/search/companies?q=tesco&items_per_page=20"
Each result carries a company number. A name search returns candidates, often many: show them to a person or compare the address, then keep the company number and look the company up by it. A name is a label; the number is the identity.
What does the company profile return?
GET /company/{company_number} returns the company profile. The fields you'll read first, as the API reference names them:
company_nameandcompany_number.company_statusandcompany_status_detail: where the company stands, such as active, dissolved or in liquidation, with any detail.date_of_creation, anddate_of_cessationfor a company that has ended.registered_office_address, andtype, the company's legal form: see company legal forms compared.sic_codes: the company's nature of business.has_insolvency_history,has_been_liquidatedandhas_charges: flags worth a closer look.accountsandconfirmation_statement: when the next ones are due, and whether they're overdue.previous_company_names.
Read the status together with the insolvency flags. An active company with an open insolvency case is still on the register; its status alone doesn't tell you the case is open.
Which other endpoints will you use?
The API reference lists many endpoints. Next to the profile and the search, these are the ones a company check usually needs:
GET /company/{company_number}/filing-history: the filings, with links to each document.GET /company/{company_number}/officers: the officers.GET /company/{company_number}/persons-with-significant-control: the persons with significant control.
Officers and persons with significant control are people: their details are personal data, to use only as data-protection law allows.
What is the rate limit?
Companies House says: "You can make up to 600 requests within a five-minute period." If you go over, you get "a 429 Too Many Requests HTTP status code for each request made within the remainder of the five-minute window". Spread your requests, retry after the window, and cache what you've already read. When you need many companies at once, use the free monthly company file instead of the API: see how to use the Companies House search and data.
What should you keep from each call?
Keep three things with each result: where it came from (the endpoint and the company number), when you called it, and what the register said, in its own words, such as company_status as returned. A status from the register is worth more than a summary of it, and a dated copy makes every decision easy to explain later.
Fuentio reads this same API for its UK answers, and adds the source, the check date and a proof code to each one, in the same format as France and Spain. See what we cover.
Limits. The quotes, endpoints and parameters come from Companies House's developer documentation, read on 26 October 2026; check them again before you build on them. The API returns what the register holds; it doesn't judge whether a company is trustworthy. Not legal advice.
Frequently asked questions
Is the Companies House API free?
Yes. You register a user account and create an application to get an API key; Companies House doesn't charge for reading public data through it.
What is developer.company-information.service.gov.uk?
Companies House's developer site: where you register, create API keys and read the API reference. The API itself answers at api.company-information.service.gov.uk.
How do I authenticate to the Companies House API?
With HTTP Basic authentication: your API key as the username and an empty password. A missing or invalid key gets 401 Unauthorized.
What is the Companies House API rate limit?
Up to 600 requests within a five-minute period. Above that, each request gets 429 Too Many Requests until the window ends.
Can I search for a company by name?
Yes, with GET /search/companies and the q parameter. Then look the right result up by its company number.
Sources
- Companies House API, getting started: developer.company-information.service.gov.uk
- API authentication: developer-specs.company-information.service.gov.uk
- Rate limiting: developer-specs.company-information.service.gov.uk
- Search companies (read on 26 October 2026): developer-specs.company-information.service.gov.uk
- Company profile resource (read on 26 October 2026): developer-specs.company-information.service.gov.uk
- API reference: developer-specs.company-information.service.gov.uk
