BETA This is a new service.

Request

GET https://api.companieshouse.gov.uk/company/{company_number}/persons-with-significant-control

Query parameters

Parameter nameValueDescriptionAdditional
company_number string The company number of the persons with significant control list being requested.
items_per_page integer The number of persons with significant control 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 PSCs which are active or were terminated during election period are shown together with full dates of birth where available. Accepted values are:
  • true
  • false
Defaults to false
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 nameValueDescriptionAdditional
ETag The ETag of the resource.

Response body

If successful, this method returns a list resource in the body.

Status codes

The following HTTP status codes may be returned, optionally with a response resource:

Status codeDescriptionResponse Resource
401 Not authorised error
400 Bad request error

CURL example

curl -uYOUR_APIKEY_FOLLOWED_BY_A_COLON: https://api.companieshouse.gov.uk/company/{company_number}/persons-with-significant-control

Examples

List persons with significant control

GET /company/01234567/persons-with-significant-control HTTP/1.1
Host: https://api.companieshouse.gov.uk
Content-Type: application/json; charset=utf-8
Authorization: Basic 0ab4b4b5fdasd10300cd4a1abb678d4032f734b
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": {
    "persons_with_significant_control_statements_list": "/company/01234567/persons-with-significant-control-statements",
    "self": "/company/01234567/persons-with-significant-control"
  },
  "items": [
    {
      "natures_of_control": [
        "ownership-of-shares-25-to-50-percent-as-person"
      ],
      "name": "James Potter",
      "links": {
        "self": "/company/01234567/persons-with-significant-control/individual/L2m6DxTJA0pkUNh9SIcJY8_cdWE"
      },
      "etag": "fe416d8a3e09c93eb961ad89b0c606982c3c01e1",
      "name_elements": {
        "forename": "James",
        "surname": "Potter"
      },
      "nationality": "British",
      "country_of_residence": "Wales",
      "address": {
        "postal_code": "CF14 3UZ",
        "locality": "Cardiff",
        "region": "South Glamorgan",
        "address_line_1": "Crown Way"
      },
      "notified_on": "2016-01-01",
      "date_of_birth": {
        "year": 1981,
        "month": 4
      }
    },
    {
      "address": {
        "region": "Mid Glamorgan",
        "address_line_1": "Cardiff Street",
        "postal_code": "CF42 6BG",
        "locality": "Treorchy",
        "premises": "46"
      },
      "etag": "kqjwejqwlejqlwjel2",
      "links": {
        "self": "company/01234567/persons-with-significant-control/corporate-entity/L2m6DxTJA0pkUNh9SIcJY8_cdWF",
        "statement": "company/01234567/persons-with-significant-control-statements/L2m6DxTJA0pkUNh9SIcJY8_cdWG"
      },
      "name": "A Company Ltd",
      "identification": {
        "country_registered": "Wales",
        "legal_authority": "Wales",
        "legal_form": "Public Limited Company",
        "place_registered": "Companies House",
        "registration_number": "INC08394823"
      },
      "natures_of_control": [
        "ownership-of-shares-50-to-75-percent-as-firm",
        "voting-rights-50-to-75-percent-as-trust"
      ],
      "notified_on": "2015-01-01"
    }
  ]
}

Explore this API

company_number The company number of the persons with significant control list being requested.
items_per_page The number of persons with significant control to return per page.
start_index The offset into the entire result set that this page starts.
register_view Display register specific information. If register is held at Companies House and register_view is set to true, only PSCs which are active or were terminated during election period are shown together with full dates of birth where available. Accepted values are:
  • true
  • false
Defaults to false

To explore this api, you must be signed in and have registered for at least one API key. Registration takes a few seconds, and allows you to explore the API from right here in the web page!

You can create an API key through Your Applications page.