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.