Companies House Public Data API: individual

Methods

get - Get the individual person with significant control notification

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",
    "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"
    },
    "kind": "string",
    "links": {
        "persons_with_significant_control": {
            "notifications": "string"
        },
        "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.
identity_verification_details	object	Information relating to the identity verification of the person with significant control	Optional
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
identity_verification_details.appointment_verification_end_on	date	The date on which the identity verification statement was removed for the notification	Optional
identity_verification_details.appointment_verification_start_on	date	The date on which the identity verification statement was supplied for the notification	Optional
identity_verification_details.appointment_verification_statement_date	date	The date from which an identity verification statement can be supplied for the notification	Optional
identity_verification_details.appointment_verification_statement_due_on	date	The date by which an identity verification statement must be supplied for the notification	Optional
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
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
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
kind	string	Possible values are: `individual-person-with-significant-control`
links	object	A set of URLs related to the resource, including self.
links.persons_with_significant_control	object	Links to other persons with significant control resources associated with this person with significant control.	Optional
links.persons_with_significant_control.notifications	string	Link to the persons with significant control notification resource that this notification is associated with.	Optional
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.

individual resource

Methods

Resource

Properties