corporateEntity resource

Methods

• get corporate entities - Get the corporate entity with significant control

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" : {
      "country_registered" : "string",
      "legal_authority" : "string",
      "legal_form" : "string",
      "place_registered" : "string",
      "registration_number" : "string"
   },
   "kind" : "string",
   "links" : {
      "self" : "string",
      "statement" : "string"
   },
   "name" : "string",
   "natures_of_control" : [
      "string"
   ],
   "notified_on" : "date"
}

Parameter Name	Type	Description	Additional
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.country_registered	string	The country or state the corporate entity with significant control is registered in.	Optional.
identification.legal_authority	string	The legal authority supervising the corporate entity with significant control.
identification.legal_form	string	The legal form of the corporate entity with significant control as defined by its country of registration.
identification.place_registered	string	The place the corporate entity with significant control is registered.	Optional.
identification.registration_number	string	The registration number of the corporate entity with significant control.	Optional.
kind	string	Possible values are: corporate-entity-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.