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 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.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.
|
|