Companies House API

Beta release

The Companies House API and Developer Hub are currently at a beta release. We are going through a process of user engagement to improve the API and documentation.

We have a proposed approach to versioning the API and documentation that is currently being discussed in the Developer Hub Forum. In the meantime existing resources will remain 'as is' and can be considered as at 'version 0'.

Please refer to the Developer Hub Forum for ongoing feature and documentation discussions, and announcements on upcoming feature releases.

Getting started

If you are new to the Companies House API, we recommend you take a look at the getting started guide, with the resources and examples provided there to help you.

We also have a support forum where you can discuss the API, find help and provide feedback.

API reference

Search

Method	HTTP Request	Description
Search all	GET /search	Search Companies House
Search company	GET /search/companies	Search companies
Search officer	GET /search/officers	Search company officers
Search disqualified officer	GET /search/disqualified-officers	Search disqualified officers

For full documentation regarding these resource URIs, see the Search page.

For a description of the resources accepted and returned by these URIs, see the CompanySearch , DisqualifiedOfficerSearch , OfficerSearch and Search resource representation pages.

Company profile

Method	HTTP Request	Description
get	GET /company/{company_number}	Get the basic company information

For full documentation regarding these resource URIs, see the Company profile page.

For a description of the resources accepted and returned by these URIs, see the companyProfile resource representation page.

Registered office address

Method	HTTP Request	Description
get	GET /company/{company_number}/ registered-office-address	Get the current address of a company

For full documentation regarding these resource URIs, see the Registered office address page.

For a description of the resources accepted and returned by these URIs, see the registeredOfficeAddress resource representation page.

Company Officers

Method	HTTP Request	Description
list	GET /company/{company_number}/officers	List the company officers
get officer appointment	GET /company/{company_number}/ appointments/{appointment_id}	Get a company officer appointment

For full documentation regarding these resource URIs, see the Company Officers page.

For a description of the resources accepted and returned by these URIs, see the officerList and officerSummary resource representation pages.

Filing history

Method	HTTP Request	Description
get	GET /company/{company_number}/ filing-history/{transaction_id}	Get the filing history of the company
list	GET /company/{company_number}/ filing-history	Get the filing history of the company

For full documentation regarding these resource URIs, see the Filing history page.

For a description of the resources accepted and returned by these URIs, see the filingHistoryItem and filingHistoryList resource representation pages.

Insolvency

Method	HTTP Request	Description
get	GET /company/{company_number}/ insolvency	Get company insolvency information

For full documentation regarding these resource URIs, see the Insolvency page.

For a description of the resources accepted and returned by these URIs, see the companyInsolvency resource representation page.

Charges

Method	HTTP Request	Description
list	GET /company/{company_number}/charges	Get a list of charges for a company
get	GET /company/{company_number}/charges/ {charge_id}	Get a single charge for a company

For full documentation regarding these resource URIs, see the Charges page.

For a description of the resources accepted and returned by these URIs, see the chargeDetails and chargeList resource representation pages.

Officer Appointment List

Method	HTTP Request	Description
list	GET /officers/{officer_id}/ appointments	List the officer appointments

For full documentation regarding these resource URIs, see the Officer Appointment List page.

For a description of the resources accepted and returned by these URIs, see the appointmentList resource representation page.

Officer disqualifications

Method	HTTP Request	Description
Get natural	GET /disqualified-officers/natural/ {officer_id}	Get a natural officer's disqualifications
Get corporate	GET /disqualified-officers/corporate/ {officer_id}	Get a corporate officer's disqualifications

For full documentation regarding these resource URIs, see the Officer disqualifications page.

For a description of the resources accepted and returned by these URIs, see the corporateDisqualification and naturalDisqualification resource representation pages.

UK establishment companies

Method	HTTP Request	Description
list	GET /company/{company_number}/ uk-establishments	Get a list of UK Establishment companies

For full documentation regarding these resource URIs, see the UK establishment companies page.

For a description of the resources accepted and returned by these URIs, see the companyUKEstablishments resource representation page.

Persons with significant control

Method	HTTP Request	Description
list	GET /company/{company_number}/ persons-with-significant-control	List the company persons with significant control
get individual	GET /company/{company_number}/ persons-with-significant-control/ individual/{psc_id}	Get the individual person with significant control
get corporate entities	GET /company/{company_number}/ persons-with-significant-control/ corporate-entity/{psc_id}	Get the corporate entity with significant control
get legal persons	GET /company/{company_number}/ persons-with-significant-control/ legal-person/{psc_id}	Get the legal person with significant control
list statements	GET /company/{company_number}/ persons-with-significant-control-statements	List the company persons with significant control statements
get statement	GET /company/{company_number}/ persons-with-significant-control-statements/ {statement_id}	Get the person with significant control statement
get super secure person	GET /company/{company_number}/ persons-with-significant-control/ super-secure/{super_secure_id}	Get the super secure person with significant control

For full documentation regarding these resource URIs, see the Persons with significant control page.

For a description of the resources accepted and returned by these URIs, see the corporateEntity , individual , legalPerson , list , statement , statementList and superSecure resource representation pages.

Company registers

Method	HTTP Request	Description
get	GET /company/{company_number}/ registers	Get the company registers information

For full documentation regarding these resource URIs, see the Company registers page.

For a description of the resources accepted and returned by these URIs, see the companyRegister resource representation page.

Company exemptions

Method	HTTP Request	Description
get	GET /company/{company_number}/ exemptions	Get the company exemptions information.

For full documentation regarding these resource URIs, see the Company exemptions page.

For a description of the resources accepted and returned by these URIs, see the companyExemptions resource representation page.