Filing History

Companies House

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

Capability: Companies House API
Current price: $0.0050/request
Availability: Ready to run

What this API does

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.

Agents select this operation with tool ID companies-house.filing-history, then check its current inputs and price before a run.

Inputs and outputs

Input

categoriesarray · optional

Official Companies House filing-history categories, applied inclusively.

minItems: 1 · maxItems: 5

company_numberstring · required

Normalized eight-character Companies House company number.

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 100

start_indexinteger · optional

Value supplied for start index.

minimum: 0 · maximum: 10000

Output

captured_atstring

Returned captured at value.

company_numberstring

Returned company number value.

itemsarray

Returned items value.

omitted_itemsnumber

Returned omitted items value.

source_urlstring

Returned source url value.

start_indexnumber

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}

Use Filing History with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.