Get filing history
get_filing_historyRetrieve filing history from Companies House to verify on-time submissions, review account reference dates, or track a competitor's filing pattern. Filter by category to reduce volume.
Instructions
What a company has filed and when — accounts, confirmation statements, officer changes, mortgages, address changes. Use it to judge whether a company is filing on time, to see when accounts were last made up, or to watch a competitor's filing cadence. Descriptions come back as Companies House template keys such as accounts-with-accounts-type-small, with their values alongside; the key is readable enough to interpret and is not translated here because a partial translation would render some filings wrongly. Filter with category to cut the volume. Needs a company number.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| verbose | No | Also return the untouched Companies House payload under `raw`, alongside the shaped result. Roughly two and a half times the size; use it only when a field you need is missing from the shaped result. | |
| category | No | Restrict to one category, e.g. accounts, confirmation-statement, officers, mortgage, address, capital, incorporation, resolution, insolvency. | |
| start_index | No | Zero-based offset into the full result set. Use pagination.has_more to decide. | |
| company_number | Yes | Eight-character Companies House number, such as 00000006 or SC123456. Leading zeros may be omitted. This tool does not accept a company name — call find_company first if that is all you have. | |
| items_per_page | No | How many records to return. Defaults to the API default; the maximum is 100. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | The untouched Companies House payload. Present only when verbose was true. | |
| meta | Yes | Provenance and budget for this answer. | |
| filings | Yes | ||
| pagination | Yes | Where this page sits in the full result set. | |
| company_number | Yes |