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",
   "etag" : "string",
   "identification" : {
      "legal_authority" : "string",
      "legal_form" : "string"
   },
   "kind" : "string",
   "links" : {
      "self" : "string",
      "statement" : "string"
   },
   "name" : "string",
   "natures_of_control" : [
      "string"
   ],
   "notified_on" : "date"
}
Parameter NameTypeDescriptionAdditional
address object The address of the person with significant control.
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.
etag string The ETag of the resource.
identification object
identification.legal_authority string The legal authority supervising the legal person with significant control.
identification.legal_form string The legal form of the legal person with significant control as defined by its country of registration.
kind string Possible values are:
  • legal-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.
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.