BETA This is a new service.

Methods

  • list - List the company officers

Resource Representation

{
   "active_count" : "integer",
   "etag" : "string",
   "inactive_count" : "integer",
   "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_on" : "date",
         "country_of_residence" : "string",
         "date_of_birth" : {
            "day" : "integer",
            "month" : "integer",
            "year" : "integer"
         },
         "former_names" : [
            {
               "forenames" : "string",
               "surname" : "string"
            }
         ],
         "identification" : {
            "identification_type" : "string",
            "legal_authority" : "string",
            "legal_form" : "string",
            "place_registered" : "string",
            "registration_number" : "string"
         },
         "links" : {
            "officer" : {
               "appointments" : "string"
            }
         },
         "name" : "string",
         "nationality" : "string",
         "occupation" : "string",
         "officer_role" : "string",
         "resigned_on" : "date"
      }
   ],
   "items_per_page" : "integer",
   "kind" : "string",
   "links" : {
      "self" : "string"
   },
   "resigned_count" : "integer",
   "start_index" : "integer",
   "total_results" : "integer"
}
Parameter NameTypeDescriptionAdditional
active_count integer The number of active officers in this result set.
etag string The ETag of the resource.
inactive_count integer The number of officers who have not resigned where the company status is dissolved or converted-closed in this result set.
items[] list The list of officers.
items[].address object The correspondence address of the officer.
items[].address.address_line_1 string The first line of the address.
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.
items[].address.locality string The locality e.g. London.
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_on date The date on which the officer was appointed.
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[].former_names[] list 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 or non-eea can be supplied, not both. Optional.
items[].identification.identification_type string Possible values are:
  • eea
  • non-eea
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[].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[].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-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
  • 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[].resigned_on date The date on which the officer resigned. 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. Optional.