Companies House Public Data API: statementList

Methods

get - List the company persons with significant control statements

Resource

{
    "active_count": "integer",
    "ceased_count": "integer",
    "items": {
        "ceased_on": "date",
        "etag": "string",
        "kind": "string",
        "linked_psc_name": "string",
        "links": {
            "person_with_significant_control": "string",
            "self": "string"
        },
        "notified_on": "date",
        "restrictions_notice_withdrawal_reason": "string",
        "statement": "string"
    },
    "items_per_page": "integer",
    "links": {
        "persons_with_significant_control_statements_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 statements in this result set.
ceased_count	integer	The number of ceased persons with significant control statements in this result set.
items	object	The list of persons with significant control statements.
items.ceased_on	date	The date that Companies House was notified about the cessation of this person with significant control.	Optional
items.etag	string	The ETag of the resource.
items.kind	string	Possible values are: `persons-with-significant-control-statement`
items.linked_psc_name	string	The name of the psc linked to this statement.	Optional
items.links	object	A set of URLs related to the resource, including self.
items.links.person_with_significant_control	string	The URL of the person with significant control linked to this statement.	Optional
items.links.self	string	The URL of the resource.
items.notified_on	date	The date that the person with significant control statement was processed by Companies House.
items.restrictions_notice_withdrawal_reason	string	The reason for the company withdrawing a `restrictions-notice-issued-to-psc` statement Possible values are: `restrictions-notice-withdrawn-by-court-order` `restrictions-notice-withdrawn-by-company` `restrictions-notice-withdrawn-by-lp` `restrictions-notice-withdrawn-by-court-order-lp` `restrictions-notice-withdrawn-by-partnership` `restrictions-notice-withdrawn-by-court-order-p`	Optional
items.statement	string	Indicates the type of statement filed. For enumeration descriptions see `statement_description` section in the enumeration mappings file. Possible values are: `no-individual-or-entity-with-signficant-control` `steps-to-find-psc-not-yet-completed` `psc-exists-but-not-identified` `psc-details-not-confirmed` `psc-contacted-but-no-response` `restrictions-notice-issued-to-psc` `psc-has-failed-to-confirm-changed-details` `no-individual-or-entity-with-signficant-control-partnership` `psc-exists-but-not-identified-partnership` `psc-details-not-confirmed-partnership` `steps-to-find-psc-not-yet-completed-partnership` `psc-contacted-but-no-response-partnership` `psc-has-failed-to-confirm-changed-details-partnership` `restrictions-notice-issued-to-psc-partnership` `all-beneficial-owners-identified` `no-beneficial-owner-identified` `at-least-one-beneficial-owner-unidentified` `information-not-provided-for-at-least-one-beneficial-owner` `at-least-one-beneficial-owner-unidentified-and-information-not-provided-for-at-least-one-beneficial-owner`
items_per_page	integer	The number of persons with significant control statements to return per page.
links	object	A set of URLs related to the resource, including self.
links.persons_with_significant_control_statements_list	string	The URL of the persons with significant control statements 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 statements in this result set.

statementList resource

Methods

Resource

Properties