# Eckari UK Company Filing History

> Eckari UK Company Filing History is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

Returns the filing history of a UK company from Companies House, including accounts, confirmation statements, officer changes, address changes, and mortgages, paginated and filterable by category

## Facts

- Endpoint: GET https://api.eckari.com/v1/companies/uk/:companyNumber/filings?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/eckari-uk-company-filing-history-e751259c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EQ5LCcNXjRGKal7ObIWtm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability eckari-uk-company-filing-history-e751259c
```

Example prompt: Can you pull up the filing history for UK company number 00445790 from Companies House — show me the last 10 filings, filtered to accounts and confirmation statements, with full detail including document URLs?

## When to prefer this

Use this endpoint when you need the chronological filing history of a specific UK company — including accounts, confirmation statements, officer changes, mortgages, and resolutions — sourced directly from the Companies House register. Prefer this over a general company profile lookup when you need to audit compliance history, check recent corporate events, or retrieve document URLs for filed forms. It is especially useful for due diligence workflows, compliance monitoring, and corporate intelligence tasks focused on UK-registered entities.

## Known failure modes

- Invalid company number format (must be 1-8 alphanumeric characters) returns INVALID_INPUT before any payment
- Company number not found in Companies House register returns a 404-equivalent error
- Category filter value not matching allowed register categories may return empty results or validation error
- Offset exceeding total filings returns an empty result set
- Rate limiting or upstream Companies House API unavailability may cause transient errors

## How this service works

Return the filing history of a UK company from the Companies House register — accounts, confirmation statements, officer appointments, address and capital changes, resolutions and mortgages — most recent first, optionally filtered by category, with date, form type (AA, CS01, AP01, TM01), the readable register description, registrar annotations and a document_url for every filed image. Use when: What has this UK company filed recently?

## Output

A paginated list of filings for the specified UK company, each including the filing date, form type code (e.g. AA, CS01, AP01), a human-readable description, registrar annotations, and a document_url linking to the filed image. In full detail mode, also includes the raw description_key and description_values. Pagination metadata indicates total filings, whether more pages exist, and the next offset to use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "company_number"
     ],
     "properties": {
      "company_number": {
       "type": "string",
       "pattern": "^\\s*(?:[0-9]{1,8}|[A-Za-z][0-9]{7}|[A-Za-z]{2}[0-9]{6}|[A-Za-z]{2}[0-9]{5}[A-Za-z]|[A-Za-z]{2}[0-9]{4}[A-Za-z]{2})\\s*$",
       "maxLength": 10,
       "minLength": 1,
       "description": "Companies House company number. Accepted shapes are the register's own — 1-8 digits (zero-padded to 8, e.g. 445790 → 00445790), one letter + 7 digits (R0000001), two letters + 6 digits (SC002180, NI000001, OC123456, OE000001), or the registered-society suffix forms (two letters + 5 digits + 1 letter; two letters + 4 digits + 2 letters). Case-insensitive; surrounding whitespace is ignored (which is why maxLength is 10); internal spaces and punctuation are not accepted. Any other value (for example PROBE) is rejected as INVALID_INPUT before payment and before any upstream call."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum filings to return per page (1-100). Default 5."
      },
      "detail": {
       "enum": [
        "summary",
        "full"
       ],
       "type": "string",
       "description": "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."
      },
      "offset": {
       "type": "integer",
       "maximum": 10000,
       "minimum": 0,
       "description": "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."
      },
      "category": {
       "type": "string",
       "pattern": "^[a-z-]+(,[a-z-]+)*$",
       "maxL
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-uk-company-filing-history-e751259c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)