List UK company filing history

company.uk.filingsv1.0.0betaregion GB

Return the filing history of a UK company from the official register — accounts, confirmation statements, officer changes, address changes, capital, resolutions and other filings — with dates, categories, filing types and register descriptions, optionally filtered by category.

Account price

USD 0.004

per successful call · introductory

x402 price

USD 0.005

accountless, settled per call · introductory

Provenance

companies_house

cache: shared · ttl 300s

Endpoint

GET https://api-staging.eckari.com/v1/companies/uk/{companyNumber}/filings

curl -i "https://api-staging.eckari.com/v1/companies/uk/01234567/filings?limit=2"

Without credentials the gateway responds 402 with a PAYMENT-REQUIRED header (x402 v2). Retry with PAYMENT-SIGNATURE. See docs.

Use when

What has this UK company filed recently?
When did company 01234567 last file accounts?
Show the filing history for this company.
List officer appointment filings for this limited company.

Do not use when

Need the current directors themselves rather than the filings; use company.uk.directors.
Need accounts due dates and last accounts summary; use company.uk.accounts.
Need registered charges/mortgages; use company.uk.charges.
Only need to know whether the company is active; use company.uk.status.

Synonyms

Companies House filing historycompany filings UKdocuments filed at Companies Houseannual accounts filedconfirmation statement filed

Input schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "companyNumber"
  ],
  "properties": {
    "companyNumber": {
      "type": "string",
      "description": "Companies House company number. Whitespace is ignored and short numeric values are zero-padded to 8 characters.",
      "minLength": 1,
      "maxLength": 10,
      "pattern": "^[A-Za-z0-9 ]+$"
    },
    "category": {
      "type": "string",
      "description": "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).",
      "maxLength": 200,
      "pattern": "^[a-z-]+(,[a-z-]+)*$"
    },
    "limit": {
      "type": "integer",
      "description": "Maximum filings to return per page (1-100). Default 25.",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "company_number",
    "total_count",
    "offset",
    "filings"
  ],
  "properties": {
    "company_number": {
      "type": "string"
    },
    "total_count": {
      "type": "integer",
      "description": "Total filings for this company (after category filter)."
    },
    "offset": {
      "type": "integer"
    },
    "filings": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "transaction_id",
          "date",
          "category",
          "type",
          "description"
        ],
        "properties": {
          "transaction_id": {
            "type": "string"
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Date the filing was processed by the register."
          },
          "category": {
            "type": "string"
          },
          "subcategory": {
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "type": "string",
            "description": "Register filing type code (e.g. AA",
            "CS01": null,
            "AP01": null,
            "TM01).": null
          },
          "description": {
            "type": "string",
            "description": "Register description key for the filing (see Companies House filing_history_descriptions enumeration)."
          },
          "pages": {
            "type": [
              "integer",
              "null"
            ]
          },
          "paper_filed": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "has_document": {
            "type": "boolean",
            "description": "Derived; true when the register exposes document metadata for this filing."
          }
        }
      }
    }
  }
}

Example input · recent_filings

{
  "companyNumber": "01234567",
  "limit": 2
}

Example response

{
  "data": {
    "company_number": "01234567",
    "total_count": 42,
    "offset": 0,
    "filings": [
      {
        "transaction_id": "MzM4NjA1NjA1NWFkaXF6a2N4",
        "date": "2025-07-02",
        "category": "confirmation-statement",
        "subcategory": null,
        "type": "CS01",
        "description": "confirmation-statement-with-no-updates",
        "pages": 3,
        "paper_filed": null,
        "has_document": true
      },
      {
        "transaction_id": "MzM3NDA1NjA1NWFkaXF6a2N4",
        "date": "2025-05-14",
        "category": "accounts",
        "subcategory": null,
        "type": "AA",
        "description": "accounts-with-accounts-type-micro-entity",
        "pages": 5,
        "paper_filed": null,
        "has_document": true
      }
    ]
  },
  "meta": {
    "capability": "company.uk.filings",
    "version": "1.0.0",
    "retrieved_at": "2026-08-17T12:00:00Z",
    "source": "companies_house",
    "freshness": "live",
    "request_id": "req_example"
  }
}

JSON OpenAPI MCP tool metadata