Companies House Public Data API: appointmentList

Methods

get - Officer Appointment List

Resource

{
    "date_of_birth": {
        "month": "integer",
        "year": "integer"
    },
    "etag": "string",
    "is_corporate_officer": "boolean",
    "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": "date",
            "appointed_on": "date",
            "appointed_to": {
                "company_name": "string",
                "company_number": "string",
                "company_status": "string"
            },
            "contact_details": {
                "contact_name": "string"
            },
            "country_of_residence": "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": {
                "company": "string"
            },
            "name": "string",
            "name_elements": {
                "forename": "string",
                "honours": "string",
                "other_forenames": "string",
                "surname": "string",
                "title": "string"
            },
            "nationality": "string",
            "occupation": "string",
            "officer_role": "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"
    },
    "name": "string",
    "start_index": "integer",
    "total_results": "integer"
}

Properties

Name	Type	Description	Additional
date_of_birth	object	The officer's date of birth details.	Optional
date_of_birth.month	integer	The month the officer was born in.
date_of_birth.year	integer	The year the officer was born in.
etag	string	The ETag of the resource.
is_corporate_officer	boolean	Indicator representing if the officer is a corporate body.
items[]	array	The list of officer appointments.
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. For example, UK.	Optional
items[].address.locality	string	The locality. For example London.	Optional
items[].address.po_box	string	The post-office box number.	Optional
items[].address.postal_code	string	The postal code. For example CF14 3UZ.	Optional
items[].address.premises	string	The property name or number.	Optional
items[].address.region	string	The region. For example Surrey.	Optional
items[].appointed_before	date	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[].appointed_to	object	The company information of the appointment.
items[].appointed_to.company_name	string	The name of the company the officer is acting for.	Optional
items[].appointed_to.company_number	string	The number of the company the officer is acting for.
items[].appointed_to.company_status	string	The status of the company the officer is acting for.	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[].former_names[]	array	Former names for the officer, if there are any.	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 appointment item.
items[].links.company	string	Link to the company profile resource that this appointment is associated with.
items[].name	string	The full name of the officer.
items[].name_elements	object	A document encapsulating the separate elements of a natural officer's name.	Optional
items[].name_elements.forename	string	The forename of the officer.	Optional
items[].name_elements.honours	string	Honours an officer might have.	Optional
items[].name_elements.other_forenames	string	Other forenames of the officer.	Optional
items[].name_elements.surname	string	The surname of the officer.
items[].name_elements.title	string	Title of the officer.	Optional
items[].nationality	string	The officer's nationality.	Optional
items[].occupation	string	The officer's occupation.	Optional
items[].officer_role	string	Possible values are: `cic-manager` `corporate-director` `corporate-llp-designated-member` `corporate-llp-member` `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` `judicial-factor` `llp-designated-member` `llp-member` `managing-officer` `member-of-a-management-organ` `member-of-a-supervisory-organ` `member-of-an-administrative-organ` `nominee-director` `nominee-secretary` `receiver-and-manager` `secretary`
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. For example, UK.	Optional
items[].principal_office_address.locality	string	The locality. For example 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. For example CF14 3UZ.	Optional
items[].principal_office_address.premises	string	The property name or number.	Optional
items[].principal_office_address.region	string	The region. For example 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 officer appointments to return per page.
kind	string	Possible values are: `personal-appointment`
links	object	Links to other resources associated with this officer appointment resource.
links.self	string	Link to this officer appointment resource.
name	string	The corporate or natural officer name.
start_index	integer	The first row of data to retrieve, starting at 0. Use this parameter as a pagination mechanism along with the `items_per_page` parameter.
total_results	integer	The total number of officer appointments in this result set.

appointmentList resource

Methods

Resource

Properties