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
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
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.