company.uk.filings

UK Company Filing History

A UK company's filings, most recent first — accounts, confirmation statements, appointments, resolutions and charges — each with form type and a link to the filed document.

Example answer

Ask

What has this UK company filed recently?

GET /v1/companies/uk/00445790/filings?limit=3

Eckari

{
  "company_number": "00445790",
  "query": {
    "category": null,
    "detail": "summary"
  },
  "filing_history_status": "filing-history-available",
  "is_filing_history_available": true,
  "items": [
    {
      "transaction_id": "MzUzNjI5NTk0OWFkaXF6a2N4",
      "date": "2026-08-06",
      "category": "capital",
      "subcategory": null,
      "type": "SH03",
      "description": "Purchase of own shares.",
      "description_source": "enumeration",
      "annotations": [
        {
          "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
          "date": "2026-08-06",
          "description": "annotation"
        }
      ],
      "pages": 4,
      "paper_filed": true,
      "has_document": true,
      "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk0OWFkaXF6a2N4/document?format=pdf"
    },
    {
      "transaction_id": "MzUzNjI5NTk1OWFkaXF6a2N4",
      "date": "2026-08-06",
      "category": "capital",
      "subcategory": null,
      "type": "SH03",
      "description": "Purchase of own shares.",
      "description_source": "enumeration",
      "annotations": [
        {
          "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
          "date": "2026-08-06",
          "description": "annotation"
        }
      ],
      "pages": 4,
      "paper_filed": true,
      "has_document": true,
      "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk1OWFkaXF6a2N4/document?format=pdf"
    },
    {
      "transaction_id": "MzUzNjI5NTk3MWFkaXF6a2N4",
      "date": "2026-08-06",
      "category": "capital",
      "subcategory": null,
      "type": "SH03",
      "description": "Purchase of own shares.",
      "description_source": "enumeration",
      "annotations": [
        {
          "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
          "date": "2026-08-06",
          "description": "annotation"
        }
      ],
      "pages": 4,
      "paper_filed": true,
      "has_document": true,
      "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk3MWFkaXF6a2N4/document?format=pdf"
    }
  ],
  "page": {
    "limit": 3,
    "offset": 0,
    "returned": 3,
    "total": 8367,
    "has_more": true,
    "next_offset": 3
  }
}

Source: Companies House
Freshness: Live
Price: $0.005

Version: 3.0.0
Transport: HTTP / MCP
Coverage: GB

Use this when

What has this UK company filed recently?
When did company 00445790 last file accounts or a confirmation statement?
Show the filing history for this company.
List officer appointment or termination filings for this limited company.
You need a link to the filed document (PDF) for a register filing.
You are building a due-diligence timeline of register events for a UK company.

Don't use this when

You need the current directors themselves rather than the filing events — use company.uk.directors.
You need accounts due dates and the last accounts summary — use company.uk.accounts.
You need registered charges or mortgages — use company.uk.charges.
You only need whether the company is active — use company.uk.status.
You need the document bytes themselves — Eckari returns the register's document_url, not the file.

If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the Companies House Public Data API record.

Input

company_numberstringrequired

Companies House company number. The identifier itself is 1-8 letters/digits; surrounding whitespace is ignored (which is why maxLength is 10), but the value must not contain internal spaces. Short numeric values are zero-padded to 8 characters. A whitespace-only or over-long value is rejected as INVALID_INPUT before any payment or upstream call.

categorystringoptional

Optional comma-separated register categories to include (e.g. accounts, address, annual-return, capital, change-of-name, incorporation, liquidation, miscellaneous, mortgage, officers, resolution, confirmation-statement). The applied value is echoed back as query.category.

detailstringoptional

How much of each filing to return. Default summary: the readable description, its source, the register's annotations, the form type and the document URL. `full` adds the register's raw description_key and description_values for reconciliation against a register capture.

limitintegeroptional

Maximum filings to return per page (1-100). Default 5.

offsetintegeroptional

Zero-based index into the register's filing list for the applied category filter. Nothing is filtered out after reading, so page.has_more is simply offset + returned < page.total; pass back page.next_offset.

What the result means

company_numberstring

queryobject

The resolved inputs, echoed because page.total depends on the category filter and the item shape depends on detail.

filing_history_statusstring, null

The register's own statement about this company's filing history, passed through unchanged (e.g. filing-history-available). It qualifies a short or empty list: without it, 'no filings match this filter' and 'the register holds no filing history for this company' look identical. Null when the register omits it.

is_filing_history_availableboolean, null

Derived; true when filing_history_status is exactly filing-history-available (the only value the register enumerates), false when it reports some other status, and null when it omits the member — the register did not say, which is never reported as 'not available'.

itemsarray

The register's own filing order, passed through unchanged — reverse chronological (most recent first) in practice. Eckari applies no sort of its own and guarantees no ordering; sort on date yourself if your logic depends on it.

pageobject

Provenance

Source: Companies House
Freshness: Live · read at request time, not cached
Region: GB
Attribution: Contains public sector information licensed under the Open Government Licence v3.0 (Companies House).

Access

Over MCP: company_uk_filings
Over HTTP: GET https://api.eckari.com/v1/companies/uk/{company_number}/filings
Price: $0.005 per call over x402. Account access $0.004 when that rail opens.