List the company persons with significant control statements
Request
GET https://api.company-information.service.gov.uk/company/{company_number}/persons-with-significant-control-statements
Query parameters
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| company_number | string | The company number of the persons with significant control statements list being requested. | |
| items_per_page | integer | The number of persons with significant control statements to return per page. | Optional. |
| start_index | integer | The offset into the entire result set that this page starts. | Optional. |
| register_view | string | Display register specific information. If register is held at Companies House and register_view is set to true, only statements which are active or were withdrawn during election period are shown. Accepted values are:
|
Optional. |
Request headers
This method does not require specific header parameters.
Request body
This method does not take any request body parameters.
Authentication
Not required.
Response
Response headers
If successful, the method returns the following headers:
| Parameter name | Value | Description | Additional |
|---|---|---|---|
| ETag | The ETag of the resource. |
Response body
If successful, this method returns a statementList resource in the body.
Status codes
The following HTTP status codes may be returned, optionally with a response resource:
| Status code | Description | Response Resource |
|---|---|---|
| 401 | Not authorised | error |
| 400 | Bad request | error |
CURL example
curl -uYOUR_APIKEY_FOLLOWED_BY_A_COLON: https://api.company-information.service.gov.uk/company/{company_number}/persons-with-significant-control-statements
Examples
List persons with significant control statements
GET /company/01234567/persons-with-significant-control-statements HTTP/1.1
Host: https://api.company-information.service.gov.uk
Content-Type: application/json; charset=utf-8
Authorization: Basic 0ab4b4b5fd2casd300cd4a1abb678d4032f734b
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
ETag: 3e7561ac11652116e31886b13d9b26cdf1ac8f4d
{
"total_results": 2,
"ceased_count": 0,
"active_count": 2,
"start_index": 0,
"items_per_page": 25
"links": {
"self": "/company/01234567/persons-with-significant-control-statements",
"persons_with_significant_control_list": "/company/01234567/persons-with-significant-control"
},
"items": [
{
"etag": "d1cdbf470d56f95c8f9882ee65a322fba83430cb",
"statement": "psc-contacted-but-no-response",
"links": {
"self": "/company/00006400/persons-with-significant-control-statements/qY2HsmhZ7P6zbUmjkIrlyjTEYBg"
},
"kind": "persons-with-significant-control-statement",
"notified_on": "2016-03-02"
},
{
"kind": "persons-with-significant-control-statement",
"notification_id": "d5YIQFsw5RfuKLsIWARNNwgfmyE",
"links": {
"self": "/company/01234567/persons-with-significant-control-statements/6q7G5BaVhNHjwLTHHU-fMuF9gk4",
"person_with_significant_control": "/company/01234567/persons-with-significant-control/individual/L2m6DxTJA0pkUNh9SIcJY8_cdWF"
},
"statement": "psc-has-failed-to-confirm-changed-details",
"linked_psc_name": "A Company Ltd",
"etag": "b748eb8730f432a0b5b7719550c2a115908311ea",
"notified_on": "2015-06-12"
}
]
}
