corporateEntity resource

Methods

  • get - Get the corporate entity 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",
    "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",
    "natures_of_control": [
        {}
    ],
    "notified_on": "date"
}

Properties

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

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

 Optional
identification.legal_authority string

The legal authority supervising the corporate entity with significant control.
identification.legal_form string

The legal form of the corporate entity with significant control as defined by its country of registration.
identification.place_registered string

The place the corporate entity with significant control is registered.

 Optional
identification.registration_number string

The registration number of the corporate entity with significant control.

 Optional
kind string

Possible values are:

  • corporate-entity-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.