# Filing History

Companies House

List UK Companies House statutory filing-history metadata for one exact company number.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Filing History (tool ID: companies-house.filing-history). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search UK company records](https://scrollport.com/tools/companies-house-api)

**Current price:** $0.0050/request

**Availability:** Ready to run

## Tool details

**About this tool**

Return one bounded filing-history page for an exact company number, optionally filtered by up to five official filing categories. Results preserve transaction identity, type, category, processing date, description, page count, paper-filing state and the canonical company filing-history link. Filing-document download and all filing actions are excluded.

**Inputs and outputs**

### Input

`categories` array · optional

Official Companies House filing-history categories, applied inclusively.

minItems: 1 · maxItems: 5

`company_number` string · required

Normalized eight-character Companies House company number.

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 100

`start_index` integer · optional

Value supplied for start index.

minimum: 0 · maximum: 10000

### Output

`captured_at` string

Returned captured at value.

`company_number` string

Returned company number value.

`items` array

Returned items value.

`omitted_items` number

Returned omitted items value.

`source_url` string

Returned source url value.

`start_index` number

Returned start index value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "companies-house.filing-history",
  "input": {
    "limit": 10,
    "categories": [
      "accounts"
    ],
    "company_number": "14367667"
  }
}
```

### Output

```
{
  "items": [
    {
      "type": "AA",
      "category": "accounts",
      "source_url": "https://find-and-update.company-information.service.gov.uk/company/14367667/filing-history",
      "description": "accounts-with-accounts-type-small",
      "filing_date": "2025-07-22",
      "transaction_id": "MzQ3NDQ3MTU2OGFkaXF6a2N4"
    }
  ],
  "source_url": "https://find-and-update.company-information.service.gov.uk/company/14367667/filing-history",
  "captured_at": "2026-08-20T00:00:00.000Z",
  "start_index": 0,
  "omitted_items": 0,
  "company_number": "14367667"
}
```

**Errors and limitations**

- `invalid_input`: company_number, categories, limit or start_index was outside the bounded filing-history contract.example: {"company_number":"14367667","categories":\["accounts"\],"limit":10}

---

Canonical page: https://scrollport.com/tools/providers/companies-house/filing-history