individual resource

Methods

  • get - Get the individual person with significant control

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",
    "country_of_residence": "string",
    "date_of_birth": {
        "day": "integer",
        "month": "integer",
        "year": "integer"
    },
    "etag": "string",
    "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 person with significant control. If given, this address will be shown on the public record instead of the residential address.
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
country_of_residence string

The country of residence of the person with significant control.
date_of_birth object

The date of birth of the person with significant control.
date_of_birth.day integer

The day of the date of birth.

 Optional
date_of_birth.month integer

The month of date of birth.
date_of_birth.year integer

The year of date of birth.
etag string

The ETag of the resource.
kind string

Possible values are:

  • individual-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. Generated by combining the name elements.
name_elements object

A document encapsulating the separate elements of a person with significant control's name.
name_elements.forename string

The forename of the person with significant control.

 Optional
name_elements.middle_name string

The middle name of the person with significant control.

 Optional
name_elements.surname string

The surname of the person with significant control.
name_elements.title string

Title of the person with significant control.

 Optional
nationality string

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