BETA This is a new service.

Request

GET https://api.companieshouse.gov.uk/company/{company_number}/officers

Query parameters

Parameter nameValueDescriptionAdditional
company_number string The company number of the officer list being requested.
items_per_page integer The number of officers to return per page. Optional.
register_type string The register_type determines which officer type is returned for the registers view. Accepted values are:
  • directors
  • secretaries
  • llp-members
The register_type field will only work if registers_view is set to true
Optional.
register_view string 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
  • false
Defaults to false
Optional.
start_index integer The offset into the entire result set that this page starts. Optional.
order_by string The field by which to order the result set. Possible values are:
  • appointed_on
  • resigned_on
  • surname
Optional. Negating the order_by will reverse the order. For example, order_by=-surname will give results in descending order of surname.

Request headers

This method does not require specific header parameters.

Request body

This method does not take any request body parameters.

Authentication

Not required.

Response

Response headers

If successful, the method returns the following headers:

Parameter nameValueDescriptionAdditional
ETag The ETag of the resource.

Response body

If successful, this method returns a officerList resource in the body.

Status codes

The following HTTP status codes may be returned, optionally with a response resource:

Status codeDescriptionResponse Resource
401 Not authorised error
400 Bad request error

CURL example

curl -uYOUR_APIKEY_FOLLOWED_BY_A_COLON: https://api.companieshouse.gov.uk/company/{company_number}/officers

Explore this API

company_number The company number of the officer list being requested.
items_per_page The number of officers to return per page.
register_type The register_type determines which officer type is returned for the registers view. Accepted values are:
  • directors
  • secretaries
  • llp-members
The register_type field will only work if registers_view is set to true
register_view 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
  • false
Defaults to false
start_index The offset into the entire result set that this page starts.
order_by The field by which to order the result set. Possible values are:
  • appointed_on
  • resigned_on
  • surname

To explore this api, you must be signed in and have registered for at least one API key. Registration takes a few seconds, and allows you to explore the API from right here in the web page!

You can create an API key through Your Applications page.