Methods

  • get - Get the individual beneficial owner

Resource

{
    "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"
}

Properties

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