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

# Filing History

### Output

<table><thead><tr><th>Attribute</th><th width="141">Type</th><th>Description</th><th>Additional</th></tr></thead><tbody><tr><td>etag</td><td>string</td><td>The ETag of the resource.</td><td></td></tr><tr><td>filingHistoryStatus</td><td>string</td><td>The status of this filing history.</td><td><p>Possible values are:</p><ul><li><code>filing-history-available</code></li></ul></td></tr><tr><td><a href="#filing-history-item">items</a></td><td>array&#x3C;object></td><td>The filing history items.</td><td></td></tr><tr><td>kind</td><td>string</td><td>Indicates this resource is a filing history.</td><td><p>Possible values are:</p><ul><li><code>filing-history</code></li></ul></td></tr><tr><td>totalCount</td><td>number</td><td>The total number of filing history items for this company.</td><td></td></tr></tbody></table>

### **Filing History Item**

| Attribute                               | Type           | Description                                                        | Additional                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------- | -------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [annotations](#annotation)              | array\<object> | Annotations for the filing.                                        | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| [associatedFilings](#associated-filing) | array\<object> | Any filings associated with the current item.                      | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| barcode                                 | string         | The barcode of the document.                                       | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| category                                | string         | The category of the document filed.                                | <p>Possible values are:</p><ul><li><code>accounts</code></li><li><code>address</code></li><li><code>annual-return</code></li><li><code>capital</code></li><li><code>change-of-name</code></li><li><code>incorporation</code></li><li><code>liquidation</code></li><li><code>miscellaneous</code></li><li><code>mortgage</code></li><li><code>officers</code></li><li><code>resolution</code></li></ul> |
| date                                    | date           | The date the filing was processed.                                 |                                                                                                                                                                                                                                                                                                                                                                                                        |
| description                             | string         | A description of the filing.                                       |                                                                                                                                                                                                                                                                                                                                                                                                        |
| [links](#links)                         | object         | Links to other resources associated with this filing history item. | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| pages                                   | number         | Number of pages within the PDF document (links.document\_metadata) | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| paperFiled                              | boolean        | If true, indicates this is a paper filing.                         | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| [resolutions](#resolution)              | array\<object> | Resolutions for the filing.                                        | Optional                                                                                                                                                                                                                                                                                                                                                                                               |
| subcategory                             | string         | The sub-category of the document filed.                            | <p>Possible values are:</p><ul><li><code>resolution</code></li></ul>                                                                                                                                                                                                                                                                                                                                   |
| transactionId                           | string         | The transaction ID of the filing.                                  |                                                                                                                                                                                                                                                                                                                                                                                                        |
| type                                    | string         | The type of filing.                                                |                                                                                                                                                                                                                                                                                                                                                                                                        |

### **Annotation**

| Attribute   | Type   | Description                        | Additional |
| ----------- | ------ | ---------------------------------- | ---------- |
| annotation  | string | The annotation text.               |            |
| date        | date   | The date the annotation was added. |            |
| description | string | A description of the annotation.   |            |

### **Associated Filing**

| Attribute   | Type   | Description                                   | Additional |
| ----------- | ------ | --------------------------------------------- | ---------- |
| date        | date   | The date the associated filing was processed. |            |
| description | string | A description of the associated filing.       |            |
| type        | string | The type of the associated filing.            |            |

### **Resolution**

| Attribute   | Type   | Description                             | Additional                                                              |
| ----------- | ------ | --------------------------------------- | ----------------------------------------------------------------------- |
| category    | string | The category of the resolution filed.   | <p>Possible values are:</p><ul><li><code>miscellaneous</code></li></ul> |
| description | string | A description of the associated filing. |                                                                         |
| documentId  | string | The document id of the resolution.      | Optional                                                                |
| receiveDate | date   | The date the resolution was processed.  |                                                                         |
| subcategory | string | The sub-category of the document filed. | <p>Possible values are:</p><ul><li><code>resolution</code></li></ul>    |
| type        | string | The type of the associated filing.      |                                                                         |

### Links

| Attribute        | Type   | Description                                                             | Additional |
| ---------------- | ------ | ----------------------------------------------------------------------- | ---------- |
| documentMetadata | string | Link to the document metadata associated with this filing history item. | Optional   |
| self             | string | Link to this filing history item.                                       | Optional   |

### Example

```
{
    "etag": "abc123",
    "filingHistoryStatus": "Accepted",
    "items": [
        {
            "annotations": [
                {
                    "annotation": "This is an annotation.",
                    "date": "2023-01-15",
                    "description": "Annotation description"
                }
            ],
            "associatedFilings": [
                {
                    "date": "2023-01-16",
                    "description": "Associated filing description",
                    "type": "Associated Filing Type"
                }
            ],
            "barcode": "123456789",
            "category": "Annual Return",
            "date": "2023-01-14",
            "description": "Filing history description",
            "links": {
                "documentMetadata": "https://example.com/document/123456789",
                "self": "https://example.com/filing/987654321"
            },
            "pages": 5,
            "paperFiled": false,
            "resolutions": [
                {
                    "category": "Ordinary resolution",
                    "description": "Resolution description",
                    "documentId": "456789012",
                    "receiveDate": "2023-01-13",
                    "subcategory": "Shareholder resolution",
                    "type": "Resolution Type"
                }
            ],
            "subcategory": "Annual Return Subcategory",
            "transactionId": "789012345",
            "type": "Filing Type"
        }
    ],
    "itemsPerPage": 10,
    "kind": "response",
    "startIndex": 0,
    "totalCount": 50
}
```