scrollport

Filing History

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

by Companies HouseReady to run$0.0050 per request · $0.50 per 100 requests

Example

You ask your agent

“Show OpenAI UK Ltd's recent accounts filings at Companies House.”

You get

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
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

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

Response

{
  "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"
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 3 →

Questions

Is Filing History by Companies House free?

Scrollport has no free tier: it costs $0.0050 per request ($0.50 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from Companies House?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to Companies House, so you don't sign up with Companies House or manage an API key.

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.

All 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

Maximum number of results to return.

minimum: 1 · maximum: 100

start_indexinteger · optional

Position of the first result to return.

minimum: 0 · maximum: 10000

Output

captured_atstring

When the data was retrieved.

company_numberstring
itemsarray

Result records.

omitted_itemsnumber

Number of items left out of the response.

source_urlstring

URL of the source the record came from.

start_indexnumber
Errors and limits
  • invalid_input: company_number, categories, limit or start_index was outside the bounded filing-history contract.example: {"company_number":"14367667","categories":["accounts"],"limit":10}