Companies House Public Data API: officerList

Methods

get - Company Officers

Resource

{
    "active_count": "integer",
    "etag": "string",
    "items": [
        {
            "address": {
                "address_line_1": "string",
                "address_line_2": "string",
                "care_of": "string",
                "country": "string",
                "locality": "string",
                "po_box": "string",
                "postal_code": "string",
                "premises": "string",
                "region": "string"
            },
            "appointed_before": "string",
            "appointed_on": "date",
            "contact_details": {
                "contact_name": "string"
            },
            "country_of_residence": "string",
            "date_of_birth": {
                "day": "integer",
                "month": "integer",
                "year": "integer"
            },
            "etag": "string",
            "former_names": [
                {
                    "forenames": "string",
                    "surname": "string"
                }
            ],
            "identification": {
                "identification_type": "string",
                "legal_authority": "string",
                "legal_form": "string",
                "place_registered": "string",
                "registration_number": "string"
            },
            "is_pre_1992_appointment": "boolean",
            "links": {
                "officer": {
                    "appointments": "string"
                },
                "self": "string"
            },
            "name": "string",
            "nationality": "string",
            "occupation": "string",
            "officer_role": "string",
            "person_number": "string",
            "principal_office_address": {
                "address_line_1": "string",
                "address_line_2": "string",
                "care_of": "string",
                "country": "string",
                "locality": "string",
                "po_box": "string",
                "postal_code": "string",
                "premises": "string",
                "region": "string"
            },
            "resigned_on": "date",
            "responsibilities": "string"
        }
    ],
    "items_per_page": "integer",
    "kind": "string",
    "links": {
        "self": "string"
    },
    "resigned_count": "integer",
    "start_index": "integer",
    "total_results": "integer"
}

Properties

Name	Type	Description	Additional
active_count	integer	The number of active officers in this result set.
etag	string	The ETag of the resource.
items[]	array	The list of officers.
items[].address	object	The correspondence address of the officer.	Optional
items[].address.address_line_1	string	The first line of the address.	Optional
items[].address.address_line_2	string	The second line of the address.	Optional
items[].address.care_of	string	The care of name.	Optional
items[].address.country	string	The country e.g. United Kingdom.	Optional
items[].address.locality	string	The locality e.g. London.	Optional
items[].address.po_box	string	The post-office box number.	Optional
items[].address.postal_code	string	The postal code e.g. CF14 3UZ.	Optional
items[].address.premises	string	The property name or number.	Optional
items[].address.region	string	The region e.g. Surrey.	Optional
items[].appointed_before	string	The date the officer was appointed before. Only present when the `is_pre_1992_appointment` attribute is `true`.	Optional
items[].appointed_on	date	The date on which the officer was appointed. For the officer roles of `corporate-managing-officer` and `managing-officer` this is the date on which Companies House was notified about the officer.	Optional
items[].contact_details	object	The contact at the `corporate-managing-officer` of a `registered-overseas-entity`.	Optional
items[].contact_details.contact_name	string	The name of the contact.	Optional
items[].country_of_residence	string	The officer's country of residence.	Optional
items[].date_of_birth	object	Details of director date of birth.	Optional
items[].date_of_birth.day	integer	The day of the date of birth.	Optional
items[].date_of_birth.month	integer	The month of date of birth.
items[].date_of_birth.year	integer	The year of date of birth.
items[].etag	string	The Etag of the resource	Optional
items[].former_names[]	array	Former names for the officer.	Optional
items[].former_names[].forenames	string	Former forenames of the officer.	Optional
items[].former_names[].surname	string	Former surnames of the officer.	Optional
items[].identification	object	Only one from `eea`, `non-eea`, `uk-limited-company`, `other-corporate-body-or-firm` or `registered-overseas-entity-corporate-managing-officer` can be supplied, not multiples of them.	Optional
items[].identification.identification_type	string	The officer's identity type Possible values are: `eea` `non-eea` `uk-limited-company` `other-corporate-body-or-firm` `registered-overseas-entity-corporate-managing-officer`	Optional
items[].identification.legal_authority	string	The legal authority supervising the company.	Optional
items[].identification.legal_form	string	The legal form of the company as defined by its country of registration.	Optional
items[].identification.place_registered	string	Place registered.	Optional
items[].identification.registration_number	string	Company registration number.	Optional
items[].is_pre_1992_appointment	boolean	Indicator representing if the officer was appointed before their appointment date.	Optional
items[].links	object	Links to other resources associated with this officer list item.
items[].links.officer	object	Links to other officer resources associated with this officer list item.
items[].links.officer.appointments	string	Link to the officer appointment resource that this appointment is associated with.
items[].links.self	string	Link to this individual company officer appointment resource.
items[].name	string	Corporate or natural officer name.
items[].nationality	string	The officer's nationality.	Optional
items[].occupation	string	The officer's job title.	Optional
items[].officer_role	string	Possible values are: `cic-manager` `corporate-director` `corporate-llp-designated-member` `corporate-llp-member` `corporate-manager-of-an-eeig` `corporate-managing-officer` `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` `managing-officer` `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`
items[].person_number	string	Unique person identifier as displayed in bulk products 195, 198, 208, 209 and 216.	Optional
items[].principal_office_address	object	The principal/registered office address of a `corporate-managing-officer` of a `registered-overseas-entity`.	Optional
items[].principal_office_address.address_line_1	string	The first line of the address.	Optional
items[].principal_office_address.address_line_2	string	The second line of the address.	Optional
items[].principal_office_address.care_of	string	The care of name.	Optional
items[].principal_office_address.country	string	The country e.g. United Kingdom.	Optional
items[].principal_office_address.locality	string	The locality e.g. London.	Optional
items[].principal_office_address.po_box	string	The post-office box number.	Optional
items[].principal_office_address.postal_code	string	The postal code e.g. CF14 3UZ.	Optional
items[].principal_office_address.premises	string	The property name or number.	Optional
items[].principal_office_address.region	string	The region e.g. Surrey.	Optional
items[].resigned_on	date	The date the officer was resigned. For the officer roles of `corporate-managing-officer` and `managing-officer` this is the date on which Companies House was notified about the officers cessation.	Optional
items[].responsibilities	string	The responsibilities of the managing officer of a `registered-overseas-entity`.	Optional
items_per_page	integer	The number of officers to return per page.
kind	string	Possible values are: `officer-list`
links	object	Links to other resources associated with this officer list resource.
links.self	string	Link to this officer list resource.
resigned_count	integer	The number of resigned officers in this result set.
start_index	integer	The offset into the entire result set that this page starts.
total_results	integer	The total number of officers in this result set.

officerList resource

Methods

Resource

Properties