Companies House Public Data API: legalPersonBeneficialOwner

Methods

get - Get the legal person beneficial owner

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": {
        "legal_authority": "string",
        "legal_form": "string"
    },
    "is_sanctioned": "boolean",
    "kind": "string",
    "links": {
        "self": "string",
        "statement": "string"
    },
    "name": "string",
    "natures_of_control": [
        {}
    ],
    "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"
    }
}

Properties

Name	Type	Description	Additional
address	object	The address of the beneficial owner.	Optional
address.address_line_1	string	The first line of the address.	Optional
address.address_line_2	string	The second line of the address.	Optional
address.care_of	string	The care of name.	Optional
address.country	string	The country. For example, United Kingdom.	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.	Optional
address.premises	string	The property name or number.	Optional
address.region	string	The region. For example Surrey.	Optional
ceased_on	date	The date that Companies House was notified about the cessation of this beneficial owner.	Optional
etag	string	The ETag of the resource.
identification	object		Optional
identification.legal_authority	string	The legal authority supervising the legal person beneficial owner.	Optional
identification.legal_form	string	The legal form of the legal person beneficial owner as defined by its country of registration.	Optional
is_sanctioned	boolean	Flag indicating if the beneficial owner was declared as being sanctioned on the latest filing of the overseas entity	Optional
kind	string	Possible values are: `legal-person-beneficial-owner`
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 beneficial owner.	Optional
name	string	Name of the beneficial owner.	Optional
natures_of_control[]	array	Indicates the nature of control the beneficial owner holds. For enumeration descriptions see `description` section in the enumeration mappings file.	Optional
notified_on	date	The date that Companies House was notified about this beneficial owner.	Optional
principal_office_address	object	The principal/registered office address of a legal-person-beneficial-owner of a registered-overseas-entity.	Optional
principal_office_address.address_line_1	string	The first line of the address.	Optional
principal_office_address.address_line_2	string	The second line of the address.	Optional
principal_office_address.care_of	string	The care of name.	Optional
principal_office_address.country	string	The country. For example, United Kingdom.	Optional
principal_office_address.locality	string	The locality. For example London.	Optional
principal_office_address.po_box	string	The post-officer box number.	Optional
principal_office_address.postal_code	string	The postal code. For example CF14 3UZ.	Optional
principal_office_address.premises	string	The property name or number.	Optional
principal_office_address.region	string	The region. For example Surrey.	Optional

legalPersonBeneficialOwner resource

Methods

Resource

Properties