> 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/insolvency.md).

# Insolvency

### Output

| Attribute                  | Type           | Description                        | Additional                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------------- | -------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [cases](#insolvency-cases) | array\<object> | List of insolvency cases.          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| etag                       | string         | The ETag of the resource.          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| status                     | string         | Company insolvency status details. | <p>Possible values are:</p><ul><li><code>live-propopsed-transfer-from-gb</code></li><li><code>voluntary-arrangement</code></li><li><code>voluntary-arrangement-receivership</code></li><li><code>live-receiver-manager-on-at-least-one-charge</code></li><li><code>receiver-manager-or-administrative-receiver</code></li><li><code>receiver-manager</code></li><li><code>administrative-receiver</code></li><li><code>administration-order</code></li><li><code>receivership</code></li><li><code>in-administration</code></li></ul> |

### Insolvency Cases

<table><thead><tr><th>Attribute</th><th width="146">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td><a href="#case-dates">dates</a></td><td>array&#x3C;object></td><td>The dates specific to the case.</td><td></td></tr><tr><td><a href="#case-links">links</a></td><td>object</td><td>The practitioners for the case.</td><td>Optional</td></tr><tr><td>notes</td><td>array&#x3C;string></td><td>Notes specific to the case.</td><td>Optional</td></tr><tr><td>number</td><td>string</td><td>The case number.</td><td>Optional</td></tr><tr><td><a href="#case-practitioners">practitioners</a></td><td>array&#x3C;object></td><td>The practitioners for the case.</td><td></td></tr><tr><td>type</td><td>string</td><td>The type of case.</td><td><p>Possible values are:</p><ul><li><code>compulsory-liquidation</code></li><li><code>creditors-voluntary-liquidation</code></li><li><code>members-voluntary-liquidation</code></li><li><code>in-administration</code></li><li><code>corporate-voluntary-arrangement</code></li><li><code>corporate-voluntary-arrangement-moratorium</code></li><li><code>administration-order</code></li><li><code>receiver-manager</code></li><li><code>administrative-receiver</code></li><li><code>receivership</code></li><li><code>foreign-insolvency</code></li><li><code>moratorium</code></li></ul></td></tr></tbody></table>

### Case Dates

<table><thead><tr><th>Attribute</th><th width="88">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td>date</td><td>date</td><td>The case date, described by date_type.</td><td></td></tr><tr><td>type</td><td>string</td><td>Describes what date is represented.</td><td><p>Possible values are:</p><ul><li><code>instrumented-on</code></li><li><code>administration-started-on</code></li><li><code>administration-discharged-on</code></li><li><code>administration-ended-on</code></li><li><code>concluded-winding-up-on</code></li><li><code>petitioned-on</code></li><li><code>ordered-to-wind-up-on</code></li><li><code>due-to-be-dissolved-on</code></li><li><code>case-end-on</code></li><li><code>wound-up-on</code></li><li><code>voluntary-arrangement-started-on</code></li><li><code>voluntary-arrangement-ended-on</code></li><li><code>moratorium-started-on</code></li><li><code>moratorium-ended-on</code></li><li><code>declaration-solvent-on</code></li></ul></td></tr></tbody></table>

### Case Links

| Attribute | Type   | Description                                         | Additonal |
| --------- | ------ | --------------------------------------------------- | --------- |
| charge    | string | The link to the charge this case is lodged against. | Optional  |

### Case Practitioners

| Attribute                        | Type           | Description                                           | Additional                                                                                                                                                                                                                                                                                                                                                           |
| -------------------------------- | -------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [address](#practitioner-address) | array\<object> | The practitioners' address.                           |                                                                                                                                                                                                                                                                                                                                                                      |
| appointedOn                      | date           | The date the practitioner was appointed on.           |                                                                                                                                                                                                                                                                                                                                                                      |
| ceasedToActOn                    | date           | The date the practitioner ceased to act for the case. |                                                                                                                                                                                                                                                                                                                                                                      |
| name                             | string         | The name of the practitioner.                         |                                                                                                                                                                                                                                                                                                                                                                      |
| role                             | string         | The type of role.                                     | <p>Optional. Possible values are:</p><ul><li><code>final-liquidator</code></li><li><code>receiver</code></li><li><code>receiver-manager</code></li><li><code>proposed-liquidator</code></li><li><code>provisional-liquidator</code></li><li><code>administrative-receiver</code></li><li><code>practitioner</code></li><li><code>interim-liquidator</code></li></ul> |

### Practitioner Address

| Attribute    | Type   | Description                            | Additional |
| ------------ | ------ | -------------------------------------- | ---------- |
| addressLine1 | string | The first line of the address.         |            |
| addressLine2 | string | The second line of the address.        | Optional   |
| country      | string | The country.                           | Optional   |
| locality     | string | The locality. For example London.      | Optional   |
| postalCode   | string | The postal code. For example CF14 3UZ. | Optional   |
| region       | string | The region. For example Surrey.        | Optional   |

### Case Type

| Attribute | Type   | Description       |
| --------- | ------ | ----------------- |
| type      | string | The type of case. |

### Example

```
{
    "cases": [
        {
            "dates": [
                {
                    "date": "2023-01-15",
                    "type": "Type A"
                },
                {
                    "date": "2023-02-20",
                    "type": "Type B"
                }
            ],
            "links": {
                "charge": "https://example.com/charge/123"
            },
            "notes": [
                "Note 1",
                "Note 2"
            ],
            "number": "CASE123",
            "practitioners": [
                {
                    "address": [
                        {
                            "addressLine1": "123 Main Street",
                            "addressLine2": "Suite 456",
                            "country": "United States",
                            "locality": "Cityville",
                            "postalCode": "12345",
                            "region": "Stateville"
                        }
                    ],
                    "appointedOn": "2023-01-10",
                    "ceasedToActOn": null,
                    "name": "John Doe",
                    "role": "Lawyer"
                }
            ],
            "type": "Legal Case"
        }
    ],
    "etag": "abc123",
    "status": "Active"
}
```