# 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, and mortgages, ordered most recent first with document URLs.

## Facts

- Endpoint: GET https://api.eckari.com/v1/companies/uk/:company_number/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-57ef57dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1d0slfV80VQyHM9tW8kiw

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-57ef57dc
```

Example prompt: Can you pull the filing history for UK company number 00445790 from Companies House — show me the last 10 filings and filter to accounts and confirmation statements only?

## When to prefer this

Use this endpoint when you need structured, paginated filing history for a specific UK company from the official Companies House register, especially when you want to filter by filing category (e.g. accounts, officers, mortgages), retrieve document URLs for filed images, or monitor recent compliance activity. Prefer this over scraping Companies House directly or using generic web search when you need machine-readable, reliable, structured output per filing with form codes and registrar annotations.

## Known failure modes

- Invalid or malformed company number (not matching 1-8 alphanumeric characters) returns INVALID_INPUT before any payment
- Company number not found in Companies House register returns a not-found error
- Invalid category filter string (wrong format or unknown category) returns a validation error
- Offset exceeding 10000 or limit outside 1-100 range returns a validation error
- Companies House upstream API unavailability causes a service error
- Payment of 0.005 USDC via x402 protocol required; insufficient funds or missing payment header causes a 402 response

## 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 containing the filing date, form type code (e.g. AA, CS01, AP01, TM01), a human-readable description, registrar annotations, and a document_url for the filed image. In full detail mode, also includes raw description_key and description_values. The response includes page metadata with total count, current offset, and a next_offset for pagination.

## 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-57ef57dc/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)