Methods

  • get - List the company persons with significant control

Resource

{
    "active_count": "integer",
    "ceased_count": "integer",
    "items": [
        {
            "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": "boolean",
            "ceased_on": "date",
            "country_of_residence": "string",
            "date_of_birth": {
                "day": "integer",
                "month": "integer",
                "year": "integer"
            },
            "description": "string",
            "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",
            "name_elements": {
                "forename": "string",
                "other_forenames": "string",
                "surname": "string",
                "title": "string"
            },
            "nationality": "string",
            "natures_of_control": [
                "string"
            ],
            "notified_on": "date"
        }
    ],
    "items_per_page": "integer",
    "links": {
        "persons_with_significant_control_list": "string",
        "self": "string"
    },
    "start_index": "integer",
    "total_results": "integer"
}

Properties

Name Type Description Additional
active_count integer

The number of active persons with significant control in this result set.

ceased_count integer

The number of ceased persons with significant control in this result set.

items[] array

The list of persons with significant control.

items[].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.

items[].address.address_line_1 string

The first line of the address.

items[].address.address_line_2 string

The second line of the address.

Optional
items[].address.care_of string

Care of name.

Optional
items[].address.country string

The country. For example, UK.

Optional
items[].address.locality string

The locality. For example London.

Optional
items[].address.po_box string

The post-officer box number.

Optional
items[].address.postal_code string

The postal code. For example CF14 3UZ.

items[].address.premises string

The property name or number.

items[].address.region string

The region. For example Surrey.

Optional
items[].ceased boolean

Presence of that indicator means the super secure person status is ceased

Optional
items[].ceased_on date

The date that Companies House was notified about the cessation of this person with significant control.

Optional
items[].country_of_residence string

The country of residence of the person with significant control.

Optional
items[].date_of_birth object

The date of birth of the person with significant control.

Optional
items[].date_of_birth.day integer

The day of the date of birth.

Optional
items[].date_of_birth.month integer

The month of date of birth.

items[].date_of_birth.year integer

The year of date of birth.

items[].description string

Description of the super secure legal statement

Possible values are:

  • super-secure-persons-with-significant-control
Optional
items[].etag string

The ETag of the resource.

items[].identification object Optional
items[].identification.country_registered string

The country or state the corporate entity with significant control is registered in.

Optional
items[].identification.legal_authority string

The legal authority supervising the corporate entity or legal person with significant control.

items[].identification.legal_form string

The legal form of the corporate entity or legal person with significant control as defined by its country of registration.

items[].identification.place_registered string

The place the corporate entity with significant control is registered.

Optional
items[].identification.registration_number string

The registration number of the corporate entity with significant control.

Optional
items[].kind string

Possible values are:

  • individual-person-with-significant-control
  • corporate-entity-person-with-significant-control
  • legal-person-with-significant-control
  • super-secure-person-with-significant-control
Optional
items[].links object

A set of URLs related to the resource, including self.

items[].links.self string

The URL of the resource.

items[].links.statement string

The URL of the statement linked to this person with significant control.

Optional
items[].name string

Name of the person with significant control.

items[].name_elements object

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

Optional
items[].name_elements.forename string

The forename of the person with significant control.

Optional
items[].name_elements.other_forenames string

Other forenames of the person with significant control.

Optional
items[].name_elements.surname string

The surname of the person with significant control.

items[].name_elements.title string

Title of the person with significant control.

Optional
items[].nationality string

The nationality of the person with significant control.

Optional
items[].natures_of_control[] array of string

Indicates the nature of control the person with significant control holds. For enumeration descriptions see description section in the enumeration mappings file.

items[].notified_on date

The date that Companies House was notified about this person with significant control.

items_per_page integer

The number of persons with significant control to return per page.

links object

A set of URLs related to the resource, including self.

links.persons_with_significant_control_list string

The URL of the persons with significant control list resource.

Optional
links.self string

The URL of the resource.

start_index integer

The offset into the entire result set that this page starts.

total_results integer

The total number of persons with significant control in this result set.