- get - Get the individual beneficial owner
{
"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",
"date_of_birth": {
"day": "integer",
"month": "integer",
"year": "integer"
},
"etag": "string",
"is_sanctioned": "boolean",
"kind": "string",
"links": {
"self": "string",
"statement": "string"
},
"name": "string",
"name_elements": {
"forename": "string",
"middle_name": "string",
"surname": "string",
"title": "string"
},
"nationality": "string",
"natures_of_control": [
{}
],
"notified_on": "date"
}
| Name |
Type |
Description |
Additional |
|
address
|
object |
The service address of the beneficial owner. If given, this address will be shown on the public record instead of the residential address.
|
Optional
|
|
address.address_line_1
|
string |
The first line of the address.
|
Optional
|
|
address.address_line_2
|
string |
The second line of the address.
|
Optional
|
|
address.care_of
|
string |
The care of name.
|
Optional
|
|
address.country
|
string |
The country. For example, United Kingdom.
|
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.
|
Optional
|
|
address.premises
|
string |
The property name or number.
|
Optional
|
|
address.region
|
string |
The region. For example Surrey.
|
Optional
|
|
ceased_on
|
date |
The date that Companies House was notified about the cessation of this beneficial owner.
|
Optional
|
|
date_of_birth
|
object |
The date of birth of the beneficial owner.
|
Optional
|
|
date_of_birth.day
|
integer |
The day of the date of birth.
|
Optional
|
|
date_of_birth.month
|
integer |
The month of date of birth.
|
Optional
|
|
date_of_birth.year
|
integer |
The year of date of birth.
|
Optional
|
|
etag
|
string |
The ETag of the resource.
|
|
|
is_sanctioned
|
boolean |
Flag indicating if the beneficial owner was declared as being sanctioned on the latest filing of the overseas entity
|
Optional
|
|
kind
|
string |
Possible values are:
individual-beneficial-owner
|
|
|
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 beneficial owner.
|
Optional
|
|
name
|
string |
Name of the beneficial owner. Generated by combining the name elements.
|
Optional
|
|
name_elements
|
object |
A document encapsulating the separate elements of a beneficial owner's name.
|
Optional
|
|
name_elements.forename
|
string |
The forename of the beneficial owner.
|
Optional
|
|
name_elements.middle_name
|
string |
The middle name of the beneficial owner.
|
Optional
|
|
name_elements.surname
|
string |
The surname of the beneficial owner.
|
|
|
name_elements.title
|
string |
Title of the beneficial owner.
|
Optional
|
|
nationality
|
string |
The nationality of the beneficial owner.
|
Optional
|
|
natures_of_control[]
|
array |
Indicates the nature of control the beneficial owner holds.
For enumeration descriptions see description section in the enumeration mappings file.
|
Optional
|
|
notified_on
|
date |
The date that Companies House was notified about this beneficial owner.
|
Optional
|