Companies House Public Data API: list

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"
            },
            "is_sanctioned": "boolean",
            "kind": "string",
            "links": {
                "self": "string",
                "statement": "string"
            },
            "name": "string",
            "name_elements": {
                "forename": "string",
                "middle_name": "string",
                "surname": "string",
                "title": "string"
            },
            "nationality": "string",
            "natures_of_control": [
                "string"
            ],
            "notified_on": "date",
            "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",
    "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[].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` `super-secure-person-with-significant-control` `individual-beneficial-owner` `corporate-entity-beneficial-owner` `legal-person-beneficial-owner` `super-secure-beneficial-owner`	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.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[].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-officer 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 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.

list resource

Methods

Resource

Properties