> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/companies-house/public-data-api/persons-with-significant-control.md).

# Persons with significant Control

### Output

<table data-full-width="false"><thead><tr><th>Attribute</th><th>Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td>activeCount</td><td>number</td><td>The number of active persons with significant control in this result set.</td><td></td></tr><tr><td>ceasedCount</td><td>number</td><td>The number of ceased persons with significant control in this result set.</td><td></td></tr><tr><td><a href="#person-with-significant-control-item">items</a></td><td>array&#x3C;object></td><td>The list of persons with significant control.</td><td></td></tr><tr><td><a href="#links">links</a></td><td>object</td><td>A set of URLs related to the resource, including self.</td><td></td></tr><tr><td>totalResults</td><td>number</td><td>The total number of persons with significant control in this result set.</td><td></td></tr></tbody></table>

### **Person With Significant Control Item**

<table data-full-width="false"><thead><tr><th width="225">Attribute</th><th>Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#address">address</a></td><td>object</td><td>The service address of the person with significant control.</td><td></td></tr><tr><td>ceased</td><td>boolean</td><td>Presence of that indicator means the super secure person status is ceased.</td><td>Optional</td></tr><tr><td>ceasedOn</td><td>date</td><td>The date that Companies House was notified about the cessation of this person with significant control.</td><td>Optional</td></tr><tr><td>countryOfResidence</td><td>string</td><td>The country of residence of the person with significant control.</td><td>Optional</td></tr><tr><td><a href="#date-of-birth">dateOfBirth</a></td><td>object</td><td>The date of birth of the person with significant control.</td><td>Optional</td></tr><tr><td>description</td><td>string</td><td>Description of the super secure legal statement. Possible values: <br>super-secure-persons-with-significant-control</td><td></td></tr><tr><td>etag</td><td>string</td><td>The ETag of the resource.</td><td></td></tr><tr><td><a href="#identification">identification</a></td><td>object</td><td>Identification information.</td><td>Optional</td></tr><tr><td>isSanctioned</td><td>boolean</td><td>Flag indicating if the beneficial owner was declared as being sanctioned on the latest filing of the overseas entity</td><td>Optional</td></tr><tr><td>kind</td><td>string</td><td>Possible values: individual-person-with-significant-control, corporate-entity-person-with-significant-control, legal-person-with-significant-control, super-secure-person-with-significant-control, individual-beneficial-owner, corporate-entity-beneficial-owner, legal-person-beneficial-owner, super-secure-beneficial-owner</td><td>Optional</td></tr><tr><td><a href="#item-links">links</a></td><td>object</td><td>A set of URLs related to the resource, including self and statement.</td><td></td></tr><tr><td>name</td><td>string</td><td>Name of the person with significant control.</td><td></td></tr><tr><td><a href="#name-elements">nameElements</a></td><td>object</td><td>Elements of the person's name.</td><td>Optional</td></tr><tr><td>nationality</td><td>string</td><td>The nationality of the person with significant control.</td><td>Optional</td></tr><tr><td>naturesOfControl</td><td>array&#x3C;string></td><td>Indicates the nature of control the person with significant control holds.</td><td></td></tr><tr><td>notifiedOn</td><td>date</td><td>The date that Companies House was notified about this person with significant control.</td><td></td></tr><tr><td><a href="#principal-office-address">principalOfficeAddress</a></td><td>object</td><td>The principal/registered office address of a corporate-entity-beneficial-owner or legal-person-beneficial-owner of a registered-overseas-entity.</td><td>Optional</td></tr></tbody></table>

### Address

| Attribute    | Type   | Description                            | Additional |
| ------------ | ------ | -------------------------------------- | ---------- |
| addressLine1 | string | The first line of the address.         |            |
| addressLine2 | string | The second line of the address.        |            |
| careOf       | string | Care of name.                          | Optional   |
| country      | string | The country. For example, UK.          | Optional   |
| locality     | string | The locality. For example, London.     | Optional   |
| poBox        | string | The post-office box number.            | Optional   |
| postalCode   | string | The postal code. For example CF14 3UZ. |            |
| premises     | string | The property name or number.           |            |
| region       | string | The region. For example, Surrey.       | Optional   |

### **Date Of Birth**

| Attribute | Type   | Description                   | Additional |
| --------- | ------ | ----------------------------- | ---------- |
| day       | number | The day of the date of birth. | Optional   |
| month     | number | The month of date of birth.   | Optional   |
| year      | number | The year of date of birth.    |            |

### **Identification**

| Attribute          | Type   | Description                                                                                                                | Additional |
| ------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------- | ---------- |
| countryRegistered  | string | The country or state the corporate entity with significant control is registered in.                                       | Optional   |
| legalAuthority     | string | The legal authority supervising the corporate entity or legal person with significant control.                             |            |
| legalForm          | string | The legal form of the corporate entity or legal person with significant control as defined by its country of registration. |            |
| placeRegistered    | string | The place the corporate entity with significant control is registered.                                                     | Optional   |
| registrationNumber | string | The registration number of the corporate entity with significant control.                                                  | Optional   |

### **Name Elements**

| Attribute      | Type   | Description                                             | Additional |
| -------------- | ------ | ------------------------------------------------------- | ---------- |
| forename       | string | The forename of the person with significant control.    | Optional   |
| otherForenames | string | Other forenames of the person with significant control. | Optional   |
| surname        | string | The surname of the person with significant control.     |            |
| title          | string | Title of the person with significant control.           |            |

### P**rincipal Office Address**

| Attribute    | Type   | Description                               | Additional |
| ------------ | ------ | ----------------------------------------- | ---------- |
| addressLine1 | string | The first line of the address.            | Optional   |
| addressLine2 | string | The second line of the address.           | Optional   |
| careOf       | string | Care of name.                             | Optional   |
| country      | string | The country. For example, United Kingdom. | Optional   |
| locality     | string | The locality. For example, London.        | Optional   |
| poBox        | string | The post-office box number.               | Optional   |
| postalCode   | string | The postal code. For example CF14 3UZ.    | Optional   |
| premises     | string | The property name or number.              | Optional   |
| region       | string | The region. For example, Surrey.          |            |

### Links

| Attribute                         | Type   | Description                                                    | Additional |
| --------------------------------- | ------ | -------------------------------------------------------------- | ---------- |
| personsWithSignificantControlList | string | The URL of the persons with significant control list resource. | Optional   |

### Item Links

| Attribute | Type   | Description                                                              | Additional |
| --------- | ------ | ------------------------------------------------------------------------ | ---------- |
| self      | string | The URL of the resource.                                                 |            |
| statement | string | The URL of the statement linked to this person with significant control. | Optional   |

### Example

```
{
    "activeCount": "integer",
    "ceasedCount": "integer",
    "items": [
        {
            "address": {
                "addressLine1": "string",
                "addressLine2": "string",
                "careOf": "string",
                "country": "string",
                "locality": "string",
                "poBox": "string",
                "postalCode": "string",
                "premises": "string",
                "region": "string"
            },
            "ceased": "boolean",
            "ceasedOn": "date",
            "countryOfResidence": "string",
            "dateOfBirth": {
                "day": "integer",
                "month": "integer",
                "year": "integer"
            },
            "description": "string",
            "etag": "string",
            "identification": {
                "countryRegistered": "string",
                "legalAuthority": "string",
                "legalForm": "string",
                "placeRegistered": "string",
                "registrationNumber": "string"
            },
            "isSanctioned": "boolean",
            "kind": "string",
            "links": {
                "self": "string",
                "statement": "string"
            },
            "name": "string",
            "nameElements": {
                "forename": "string",
                "otherForenames": "string",
                "surname": "string",
                "title": "string"
            },
            "nationality": "string",
            "naturesOfControl": [
                "string"
            ],
            "notifiedOn": "date",
            "principalOfficeAddress": {
                "addressLine1": "string",
                "addressLine2": "string",
                "careOf": "string",
                "country": "string",
                "locality": "string",
                "poBox": "string",
                "postalCode": "string",
                "premises": "string",
                "region": "string"
            }
        }
    ],
    "links": {
        "personsWithSignificantControlList": "string",
        "self": "string"
    },
    "totalResults": "integer"
}
```