BETA This is a new service.

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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
list
GET /company/{company_number}/officers
List the company officers

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 resource representation page.

Filing history

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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

MethodHTTP RequestDescription
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.