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}/ |
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}/ |
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}/ |
Get the filing history of the company |
list | GET /company/{company_number}/ |
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}/ |
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/ |
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}/ |
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/ |
Get a natural officer's disqualifications |
Get corporate | GET /disqualified-officers/corporate/ |
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}/ |
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}/ |
List the company persons with significant control |
get individual | GET /company/{company_number}/ |
Get the individual person with significant control |
get corporate entities | GET /company/{company_number}/ |
Get the corporate entity with significant control |
get legal persons | GET /company/{company_number}/ |
Get the legal person with significant control |
list statements | GET /company/{company_number}/ |
List the company persons with significant control statements |
get statement | GET /company/{company_number}/ |
Get the person with significant control statement |
get super secure person | GET /company/{company_number}/ |
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}/ |
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}/ |
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.