> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/companies-house/public-data-api/registers.md).

# Registers

* `directors`

Possible values are:

The register type.

### Output

| Attribute               | Type   | Description                            | Additional                                                          |
| ----------------------- | ------ | -------------------------------------- | ------------------------------------------------------------------- |
| companyNumber           | string | The number of the company.             |                                                                     |
| etag                    | string | The ETag of the resource.              | Optional                                                            |
| kind                    | string | Kind of response                       | <p>Possible values are:</p><ul><li><code>registers</code></li></ul> |
| [links](#links)         | object | A set of URLs related to the resource. |                                                                     |
| [registers](#registers) | object | Company registers information.         |                                                                     |

### Registers

<table><thead><tr><th width="285">Attribute</th><th>Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#directors">directors</a></td><td>object</td><td>List of registered company directors.</td><td></td></tr><tr><td><a href="#llp-members">llpMembers</a></td><td>object</td><td>List of registered llp members.</td><td></td></tr><tr><td><a href="#llp-usual-residential-address">llpUsualResidentialAddress</a></td><td>object</td><td>List of register addresses.</td><td></td></tr><tr><td><a href="#members">members</a></td><td>object</td><td>List of registered company members.</td><td></td></tr><tr><td><a href="#persons-with-significant-control">personsWithSignificantControl</a></td><td>object</td><td>List of registered company persons with significant control.<br></td><td></td></tr><tr><td><a href="#secretaries">secretaries</a></td><td>object</td><td>List of registered company secretaries.</td><td></td></tr><tr><td><a href="#usual-residential-address">usualResidentialAddress</a></td><td>object</td><td>List of register addresses.</td><td></td></tr></tbody></table>

### Directors

<table><thead><tr><th>Attribute</th><th width="155">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#items">items</a></td><td>array&#x3C;object></td><td></td><td></td></tr><tr><td><a href="#directors-links">links</a></td><td>object</td><td>A set of URLs related to the resource.</td><td>Optional</td></tr><tr><td>registerType</td><td>string</td><td>The register type.</td><td><p>Possible values are:</p><ul><li><code>directors</code></li></ul></td></tr></tbody></table>

### Directors Links

| Attribute         | Type   | Description               |
| ----------------- | ------ | ------------------------- |
| directorsRegister | string | The URL for the resource. |

### LLP Members

<table><thead><tr><th>Attribute</th><th width="152">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#items">items</a></td><td>array&#x3C;object></td><td></td><td></td></tr><tr><td><a href="#llp-members-links">links</a></td><td>object</td><td>A set of URLs related to the resource.</td><td>Optional</td></tr><tr><td>registerType</td><td>string</td><td>The register type.</td><td><p>Possible values are:</p><ul><li><code>llp-members</code></li></ul></td></tr></tbody></table>

### LLP Members Links

| Attribute  | Type   | Description               |
| ---------- | ------ | ------------------------- |
| llpMembers | string | The URL for the resource. |

### LLP Usual Residential Address

<table><thead><tr><th>Attribute</th><th width="153">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#items">items</a></td><td>array&#x3C;object></td><td></td><td></td></tr><tr><td><a href="#llp-usual-residential-address-links">links</a></td><td>object</td><td>A set of URLs related to the resource.</td><td>Optional</td></tr><tr><td>registerType</td><td>string</td><td>The register type.</td><td><p>Possible values are:</p><ul><li><code>llp-usual-residential-address</code></li></ul></td></tr></tbody></table>

### LLP Usual Residential Address Links

<table><thead><tr><th width="261.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>llpUsualResidentialAddress</td><td>string</td><td>The URL for the resource.</td></tr></tbody></table>

### Members

<table><thead><tr><th>Attribute</th><th width="142">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#items">items</a></td><td>array&#x3C;object></td><td></td><td></td></tr><tr><td><a href="#members-links">links</a></td><td>object</td><td>A set of URLs related to the resource.</td><td>Optional</td></tr><tr><td>registerType</td><td>string</td><td>The register type.</td><td><p>Possible values are:</p><ul><li><code>members</code></li></ul></td></tr></tbody></table>

### Members Links

<table><thead><tr><th width="261.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>members</td><td>string</td><td>The URL for the resource.</td></tr></tbody></table>

### Persons With Significant Control

<table><thead><tr><th>Attribute</th><th width="146">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#items">items</a></td><td>array&#x3C;object></td><td></td><td></td></tr><tr><td><a href="#persons-with-significant-control-links">links</a></td><td>object</td><td>A set of URLs related to the resource.</td><td>Optional</td></tr><tr><td>registerType</td><td>string</td><td>The register type.</td><td><p>Possible values are:</p><ul><li><code>persons-with-significant-control</code></li></ul></td></tr></tbody></table>

### Persons With Significant Control Links

<table><thead><tr><th width="342.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>personsWithSignificantControlRegister</td><td>string</td><td>The URL for the resource.</td></tr></tbody></table>

### Secretaries

| Attribute                   | Type           | Description                            | Additional                                                            |
| --------------------------- | -------------- | -------------------------------------- | --------------------------------------------------------------------- |
| [items](#items)             | array\<object> |                                        |                                                                       |
| [links](#secretaries-links) | object         | A set of URLs related to the resource. | Optional                                                              |
| registerType                | string         | The register type.                     | <p>Possible values are:</p><ul><li><code>secretaries</code></li></ul> |

### Secretaries Links

<table><thead><tr><th width="342.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>secretariesRegister</td><td>string</td><td>The URL for the resource.</td></tr></tbody></table>

### Usual Residential Address

| Attribute                                 | Type           | Description                            | Additional                                                                          |
| ----------------------------------------- | -------------- | -------------------------------------- | ----------------------------------------------------------------------------------- |
| [items](#items)                           | array\<object> |                                        |                                                                                     |
| [links](#usual-residential-address-links) | object         | A set of URLs related to the resource. | Optional                                                                            |
| registerType                              | string         | The register type.                     | <p>Possible values are:</p><ul><li><code>usual-residential-address</code></li></ul> |

### Usual Residential Address Links

<table><thead><tr><th width="342.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>usualResidentialAddress</td><td>string</td><td>The URL for the resource.</td></tr></tbody></table>

### Items

<table><thead><tr><th>Attribute</th><th width="106">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#item-links">links</a></td><td>object</td><td>A set of URLs related to the resource.</td><td></td></tr><tr><td>movedOn</td><td>date</td><td>The date registered on.</td><td></td></tr><tr><td>registerMovedTo</td><td>string</td><td>Location of registration.</td><td><p>Possible values are:</p><ul><li><code>public-register</code></li><li><code>registered-office</code></li><li><code>single-alternative-inspection-location</code></li><li><code>unspecified-location</code></li></ul></td></tr></tbody></table>

### Links

| Attribute | Type   | Description              |
| --------- | ------ | ------------------------ |
| self      | string | The URL of the resource. |

### Item Links

| Attribute | Type   | Description                                  |
| --------- | ------ | -------------------------------------------- |
| filing    | string | The URL of the transaction for the resource. |

### Example

```
{
  "companyNumber": "ABC123",
  "etag": "123456",
  "kind": "company",
  "links": {
    "self": "/companies/ABC123"
  },
  "registers": {
    "directors": {
      "items": [
        {
          "links": {
            "directorsRegister": "/registers/directors/1"
          },
          "movedOn": "2023-08-01",
          "registerMovedTo": "/registers/directors/2"
        },
        {
          "links": {
            "directorsRegister": "/registers/directors/2"
          },
          "movedOn": "2023-08-15",
          "registerMovedTo": null
        }
      ],
      "links": {
        "directorsRegister": "/registers/directors"
      },
      "registerType": "directors"
    },
    "llpMembers": {
      "items": [
        {
          "links": {
            "llpMembers": "/registers/llp-members/1"
          },
          "movedOn": "2023-07-20",
          "registerMovedTo": "/registers/llp-members/2"
        }
      ],
      "links": {
        "llpMembers": "/registers/llp-members"
      },
      "registerType": "llp-members"
    },
    "llpUsualResidentialAddress": {
      "items": [
        {
          "links": {
            "llpUsualResidentialAddress": "/registers/llp-usual-residential/1"
          },
          "movedOn": "2023-06-10",
          "registerMovedTo": "/registers/llp-usual-residential/2"
        }
      ],
      "links": {
        "llpUsualResidentialAddress": "/registers/llp-usual-residential"
      },
      "registerType": "llp-usual-residential"
    },
    "members": {
      "items": [
        {
          "links": {
            "members": "/registers/members/1"
          },
          "movedOn": "2023-05-05",
          "registerMovedTo": "/registers/members/2"
        }
      ],
      "links": {
        "members": "/registers/members"
      },
      "registerType": "members"
    },
    "personsWithSignificantControl": {
      "items": [
        {
          "links": {
            "personsWithSignificantControlRegister": "/registers/psc/1"
          },
          "movedOn": "2023-04-01",
          "registerMovedTo": "/registers/psc/2"
        }
      ],
      "links": {
        "personsWithSignificantControlRegister": "/registers/psc"
      },
      "registerType": "psc"
    },
    "secretaries": {
      "items": [
        {
          "links": {
            "secretariesRegister": "/registers/secretaries/1"
          },
          "movedOn": "2023-03-15",
          "registerMovedTo": "/registers/secretaries/2"
        }
      ],
      "links": {
        "secretariesRegister": "/registers/secretaries"
      },
      "registerType": "secretaries"
    },
    "usualResidentialAddress": {
      "items": [
        {
          "links": {
            "usualResidentialAddress": "/registers/usual-residential/1"
          },
          "movedOn": "2023-02-10",
          "registerMovedTo": "/registers/usual-residential/2"
        }
      ],
      "links": {
        "usualResidentialAddress": "/registers/usual-residential"
      },
      "registerType": "usual-residential"
    }
  }
}
```