Companies House is the United Kingdom registrar of companies and is an executive agency of the government. This entity is responsible for the Companies House API(opens new window) , which allows you to retrieve information on companies in the United Kingdom.
All requests must be authenticated by means of an OIDC access token, supplied as an Authorization header of type Bearer. For more instructions on how to obtain such a token, please refer to Accessing Signicat REST services. When retrieving the token, the scope client.companieshouse.search.get must be specified.
The difference between the methods is that the most generic one (/companieshouse/search) searches across all indexed information (companies, officers and disqualified officers), and the other one searches only in the companies repository.
The register_type determines which officer type is returned for the registers view. Accepted values are:directors``secretaries``llp-membersThe register_type field will only work if registers_view is set to true
Display register specific information. If given register is held at Companies House, registers_view set to true and correct register_type specified, only active officers will be returned. Those will also have full date of birth. Accepted values are:true``falseDefaults to false
The index of the first result item to return.
order_by optional officers
The field by which to order the result set. Possible values are:appointed_on``resigned_on``surnameNegating the order_bywill reverse the order. For example, order_by=-surname will give results in descending order of surname
A single line address. This will be the address that matched within the indexed document, or the primary address otherwise (as returned by the address member).
company_number companies search
The company registration / incorporation number of the company.
company_status companies search
The company status. Possible values are:active``dissolved``liquidation``receivership``administration``voluntary-arrangement``converted-closed``insolvency-proceedings
company_type companies search
The company type. Possible values are:private-unlimited``ltd``plc``old-public-company``private-limited-guarant-nsc-limited-exemption``limited-partnership``private-limited-guarant-nsc``converted-or-closed``private-unlimited-nsc``private-limited-shares-section-30-exemption``assurance-company``oversea-company``eeig``icvc-securities``icvc-warrant``icvc-umbrella``industrial-and-provident-society``northern-ireland``northern-ireland-other``llp``royal-charter``investment-company-with-variable-capital``unregistered-company``llp``other``european-public-limited-liability-company-se
date_of_cessation optional companies search
The date the company ended.
date_of_creation optional companies search
The date the company was created.
The result description.
An array of Enumeration types that make up the search description. See search_descriptions_raw.yaml in api-Enumerations
The type of search result. Depending on the endpoint used possible values are:searchresult#company``searchresults#officer``searchresults#disqualified-officer
The URL of the search result.
The URL of the resource being returned by the search item.
An array of character offset into the address_snippet String. These always occur in pairs, and define the start and end of subStrings in the member address_snippet that matched the search terms.
An array of character offset into the snippet String. These always occur in pairs, and define the start and end of subStrings in the member snippet that matched the search terms. The first character of the String is index 1.
An array of character offset into the title String. These always occur in pairs, and define the start and end of subStrings in the member title that matched the search terms. The first character of the String is index 1.
Only one from eea or non-eea can be supplied, not both.
Links to other resources associated with this officer list item.
Links to other officer resources associated with this officer list item.
Link to the officer appointment resource that this appointment is associated with.
Corporate or natural officer name.
The officer's nationality.
The officer's job title.
Possible values are:cic-manager``corporate-director``corporate-llp-designated-member``corporate-llp-member``corporate-manager-of-an-eeig``corporate-member-of-a-management-organ``corporate-member-of-a-supervisory-organ``corporate-member-of-an-administrative-organ``corporate-nominee-director``corporate-nominee-secretary``corporate-secretary``director``general-partner-in-a-limited-partnership``judicial-factor``limited-partner-in-a-limited-partnership``llp-designated-member``llp-member``manager-of-an-eeig``member-of-a-management-organ``member-of-a-supervisory-organ``member-of-an-administrative-organ``nominee-director``nominee-secretary``person-authorised-to-accept``person-authorised-to-represent``person-authorised-to-represent-and-accept``receiver-and-manager``secretary