scrollport
Back to UK company due diligence

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/call
Availability
Ready to run
Last accepted verification

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 inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

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"
}
Teaching 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}
Updated
22 August 2026

Use Filing History with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.