Companies House Public Data API: officerSummary

Methods

get - Get a company officer appointment

Resource

{
    "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"
}

Properties

Name	Type	Description	Additional
address	object	The correspondence address of the officer.	Optional
address.address_line_1	string	The first line of the address.	Optional
address.address_line_2	string	The second line of the address.	Optional
address.care_of	string	The care of name.	Optional
address.country	string	The country e.g. United Kingdom.	Optional
address.locality	string	The locality e.g. London.	Optional
address.po_box	string	The post-office box number.	Optional
address.postal_code	string	The postal code e.g. CF14 3UZ.	Optional
address.premises	string	The property name or number.	Optional
address.region	string	The region e.g. Surrey.	Optional
appointed_before	string	The date the officer was appointed before. Only present when the `is_pre_1992_appointment` attribute is `true`.	Optional
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
contact_details	object	The contact at the `corporate-managing-officer` of a `registered-overseas-entity`.	Optional
contact_details.contact_name	string	The name of the contact.	Optional
country_of_residence	string	The officer's country of residence.	Optional
date_of_birth	object	Details of director date of birth.	Optional
date_of_birth.day	integer	The day of the date of birth.	Optional
date_of_birth.month	integer	The month of date of birth.
date_of_birth.year	integer	The year of date of birth.
etag	string	The Etag of the resource	Optional
former_names[]	array	Former names for the officer.	Optional
former_names[].forenames	string	Former forenames of the officer.	Optional
former_names[].surname	string	Former surnames of the officer.	Optional
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
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
identification.legal_authority	string	The legal authority supervising the company.	Optional
identification.legal_form	string	The legal form of the company as defined by its country of registration.	Optional
identification.place_registered	string	Place registered.	Optional
identification.registration_number	string	Company registration number.	Optional
is_pre_1992_appointment	boolean	Indicator representing if the officer was appointed before their appointment date.	Optional
links	object	Links to other resources associated with this officer list item.
links.officer	object	Links to other officer resources associated with this officer list item.
links.officer.appointments	string	Link to the officer appointment resource that this appointment is associated with.
links.self	string	Link to this individual company officer appointment resource.
name	string	Corporate or natural officer name.
nationality	string	The officer's nationality.	Optional
occupation	string	The officer's job title.	Optional
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`
person_number	string	Unique person identifier as displayed in bulk products 195, 198, 208, 209 and 216.	Optional
principal_office_address	object	The principal/registered office address of a `corporate-managing-officer` of a `registered-overseas-entity`.	Optional
principal_office_address.address_line_1	string	The first line of the address.	Optional
principal_office_address.address_line_2	string	The second line of the address.	Optional
principal_office_address.care_of	string	The care of name.	Optional
principal_office_address.country	string	The country e.g. United Kingdom.	Optional
principal_office_address.locality	string	The locality e.g. London.	Optional
principal_office_address.po_box	string	The post-office box number.	Optional
principal_office_address.postal_code	string	The postal code e.g. CF14 3UZ.	Optional
principal_office_address.premises	string	The property name or number.	Optional
principal_office_address.region	string	The region e.g. Surrey.	Optional
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
responsibilities	string	The responsibilities of the managing officer of a `registered-overseas-entity`.	Optional

officerSummary resource

Methods

Resource

Properties