Developer API Suite

notificationList resource

Methods

  • get - Persons with significant control Notification List

Resource

{
    "active_count": "integer",
    "ceased_count": "integer",
    "date_of_birth": {
        "month": "integer",
        "year": "integer"
    },
    "inactive_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_on": "date",
            "country_of_residence": "string",
            "etag": "string",
            "identification": {
                "country_registered": "string",
                "legal_authority": "string",
                "legal_form": "string",
                "place_registered": "string",
                "registration_number": "string"
            },
            "identity_verification_details": {
                "anti_money_laundering_supervisory_bodies": [
                    "string"
                ],
                "appointment_verification_end_on": "date",
                "appointment_verification_start_on": "date",
                "appointment_verification_statement_date": "date",
                "appointment_verification_statement_due_on": "date",
                "authorised_corporate_service_provider_name": "string",
                "identity_verified_on": "date",
                "preferred_name": "string"
            },
            "is_sanctioned": "boolean",
            "kind": "string",
            "links": {
                "company": "string"
            },
            "name": "string",
            "name_elements": {
                "forename": "string",
                "middle_name": "string",
                "surname": "string",
                "title": "string"
            },
            "nationality": "string",
            "natures_of_control": [
                "string"
            ],
            "notified_on": "date",
            "notified_to": {
                "company_name": "string",
                "company_number": "string",
                "company_status": "string"
            },
            "principal_office_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"
            }
        }
    ],
    "items_per_page": "integer",
    "kind": "string",
    "links": {
        "self": "string"
    },
    "name": "string",
    "start_index": "integer",
    "total_results": "integer"
}

Properties

Name Type Description Additional
active_count integer

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

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

The date of birth of the person with significant control.

 Optional
date_of_birth.month integer

The month of date of birth.
date_of_birth.year integer

The year of date of birth.
inactive_count integer

The number of inactive persons with significant control notifications in this result set.
items[] array

The list of person with significant control notifications.
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-office 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_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[].etag string

The ETag of the resource.
items[].identification object

Information related to the registration of either a corporate-entity-person-with-significant-control or a corporate-entity-beneficial-owner.

 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[].identity_verification_details object

Information relating to the identity verification of the person with significant control.

 Optional
items[].identity_verification_details.anti_money_laundering_supervisory_bodies[] array of string

The Anti-Money Laundering supervisory bodies that the authorised corporate service provider was registered with when verifying the person with significant control

 Optional
items[].identity_verification_details.appointment_verification_end_on date

The date on which the identity verification statement was removed for the notification.

 Optional
items[].identity_verification_details.appointment_verification_start_on date

The date on which the identity verification statement was supplied for the notification.

 Optional
items[].identity_verification_details.appointment_verification_statement_date date

The date from which an identity verification statement can be supplied for the notification.

 Optional
items[].identity_verification_details.appointment_verification_statement_due_on date

The date by which an identity verification statement must be supplied for the notification.

 Optional
items[].identity_verification_details.authorised_corporate_service_provider_name string

The name of the authorised corporate service provider that verified the identity of the person with significant control.

 Optional
items[].identity_verification_details.identity_verified_on date

The date on which the authorised corporate service provider verified the identity of the person with significant control.

 Optional
items[].identity_verification_details.preferred_name string

The name provided to the authorised corporate service provider by which the person with significant control prefers to be known.

 Optional
items[].is_sanctioned boolean

Flag indicating if the beneficial owner was declared as being sanctioned on the latest filing of the overseas entity.

 Optional
items[].kind string

Possible values are:

  • individual-person-with-significant-control
  • corporate-entity-person-with-significant-control
  • legal-person-with-significant-control
  • individual-beneficial-owner
  • corporate-entity-beneficial-owner
  • legal-person-beneficial-owner

 Optional
items[].links object

Links to other resources associated with this person with significant control notification resource.
items[].links.company string

Link to the company profile resource that this notification is associated with.
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.middle_name string

The middle name 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[].notified_to object

The company information of the notification.
items[].notified_to.company_name string

The name of the company the person with significant control is notified to.

 Optional
items[].notified_to.company_number string

The number of the company the person with significant control is notified to.
items[].notified_to.company_status string

The status of the company the person with significant control is notified to.

 Optional
items[].principal_office_address object

The principal/registered office address of a corporate-entity-beneficial-owner or legal-person-beneficial-owner of a registered-overseas-entity.

 Optional
items[].principal_office_address.address_line_1 string

The first line of the address.

 Optional
items[].principal_office_address.address_line_2 string

The second line of the address.

 Optional
items[].principal_office_address.care_of string

The care of name.

 Optional
items[].principal_office_address.country string

The country. For example, United Kingdom.

 Optional
items[].principal_office_address.locality string

The locality. For example London.

 Optional
items[].principal_office_address.po_box string

The post-office box number.

 Optional
items[].principal_office_address.postal_code string

The postal code. For example CF14 3UZ.

 Optional
items[].principal_office_address.premises string

The property name or number.

 Optional
items[].principal_office_address.region string

The region. For example Surrey.

 Optional
items_per_page integer

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

Possible values are:

  • personal-notification
links object

Links to other resources associated with this person with significant control notification resource.
links.self string

Link to this person with significant control notification resource.
name string

The person with significant control name.
start_index integer

The first row of data to retrieve, starting at 0. Use this parameter as a pagination mechanism along with the items_per_page parameter.
total_results integer

The total number of persons with significant control notifications in this result set.
Built by Companies House