# UK Company Filing History

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

Returns recent filing history and key compliance dates for a UK company from Companies House, excluding officer and PSC filings.

## Facts

- Endpoint: GET https://pennydatahq.com/api/filings/:number?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-company-filing-history-588ef248
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l3XwbCUaqbGGwg10-tg8R

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 uk-company-filing-history-588ef248
```

Example prompt: Can you pull the recent filing history for UK company number 09876543 from Companies House — I want to see the latest filings and check when their accounts and confirmation statement are next due.

## When to prefer this

Use this endpoint when you need structured, machine-readable UK Companies House filing data for a known company number, particularly for compliance checks, due diligence workflows, or monitoring accounts and confirmation statement deadlines. It is preferable over scraping Companies House directly due to its JSON output and pay-per-call pricing. Choose it when you need recent filing history without officer or PSC appointment data.

## Known failure modes

- Invalid or non-existent company number returns an error or empty result
- Company number format must be up to 8 digits or a valid 2-letter prefix (e.g. SC) followed by digits — malformed inputs will fail
- Dissolved companies may return limited or no filing data
- Companies House API downtime may cause upstream failures
- Truncated response — only up to 25 filings returned, older history not available

## How this service works

Recent filings and key dates for a UK company from the Companies House public register: accounts and confirmation statement dates and the latest filings by date and form type, as JSON. Officer and PSC filings are excluded.

## Output

A JSON object containing the company number, company name, key compliance dates (accounts and confirmation statement next-due and last-made-up-to dates, overdue flags, incorporation date, dissolution date), and up to 25 most recent filings (excluding officer and PSC filings) each with date, form type, category, made-up date, and description code.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "number"
     ],
     "properties": {
      "number": {
       "type": "string",
       "description": "Companies House company number: up to 8 digits, or a 2-letter prefix such as SC followed by digits."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "company_number",
      "company_name",
      "key_dates",
      "filings"
     ],
     "properties": {
      "status": {
       "type": [
        "string",
        "null"
       ]
      },
      "filings": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "date": {
          "type": [
           "string",
           "null"
          ],
          "description": "YYYY-MM-DD"
         },
         "form": {
          "type": [
           "string",
           "null"
          ],
          "description": "Companies House form type, for example AA or CS01"
         },
         "category": {
          "type": [
           "string",
           "null"
          ]
         },
         "made_up_date": {
          "type": [
           "string",
           "null"
          ],
          "description": "YYYY-MM-DD"
         },
         "description_code": {
          "type": [
           "string",
           "null"
          ],
          "description": "Companies House filing description key"
         }
        }
       },
       "description": "Up to 25, newest first; officer and PSC filings excluded"
      },
      "key_dates": {
       "type": "object",
       "properties": {
        "accounts": {
         "type": "object",
         "properties": {
          "overdue": {
           "type": [
            "boolean",
            "null"
           ]
          },
          "next_due": {
           "type": [
            "string",
            "null"
           ]
… (truncated)
```

## More

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