BETA This is a new service.

Methods

Resource Representation

{
   "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"
   },
   "ceased_on" : "date",
   "country_of_residence" : "string",
   "date_of_birth" : {
      "day" : "integer",
      "month" : "integer",
      "year" : "integer"
   },
   "etag" : "string",
   "kind" : "string",
   "links" : {
      "self" : "string",
      "statement" : "string"
   },
   "name" : "string",
   "name_elements" : {
      "forename" : "string",
      "other_forenames" : "string",
      "surname" : "string",
      "title" : "string"
   },
   "nationality" : "string",
   "natures_of_control" : [
      "string"
   ],
   "notified_on" : "date"
}
Parameter NameTypeDescriptionAdditional
address object The service address of the person with significant control. If given, this address will be shown on the public record instead of the residential address.
address.address_line_1 string The first line of the address.
address.address_line_2 string The second line of the address. Optional.
address.care_of string Care of name. Optional.
address.country string The country. For example, UK. Optional.
address.locality string The locality. For example London. Optional.
address.po_box string The post-officer box number. Optional.
address.postal_code string The postal code. For example CF14 3UZ.
address.premises string The property name or number.
address.region string The region. For example Surrey. Optional.
ceased_on date The date that Companies House was notified about the cessation of this person with significant control. Optional.
country_of_residence string The country of residence of the person with significant control.
date_of_birth object The date of birth of the person with significant control. The day field will only be returned when properly authenticated.
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.
kind string Possible values are:
  • individual-person-with-significant-control
links object A set of URLs related to the resource, including self.
links.self string The URL of the resource.
links.statement string The URL of the statement linked to this person with significant control. Optional.
name string Name of the person with significant control.
name_elements object A document encapsulating the seperate elements of a person with significant control's name.
name_elements.forename string The forename of the person with significant control. Optional.
name_elements.other_forenames string Other forenames of the person with significant control. Optional.
name_elements.surname string The surname of the person with significant control.
name_elements.title string Title of the person with significant control. Optional.
nationality string The nationality of the person with significant control.
natures_of_control Array Indicates the nature of control the person with significant control holds.

For enumeration descriptions see description section in the enumeration mappings file.

notified_on date The date that Companies House was notified about this person with significant control.