# Companies House Filing History API

> Companies House Filing History API is a paid API for AI agents from company.payapi.market, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the statutory filing history for a UK company from Companies House, including accounts, confirmation statements, officer appointments, charges, and other filings.

## Facts

- Endpoint: POST https://company.payapi.market/filings
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/companies-house-filing-history-api-acc31f00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SImhxAZalhcKklwjqTTQK

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 companies-house-filing-history-api-acc31f00 -d '<json body>'
```

Example prompt: Can you pull the last 10 Companies House filings for Tesco PLC — company number 00445790 — so I can see their most recent accounts and confirmation statements?

## When to prefer this

Use this endpoint when you need the statutory filing timeline for a specific UK registered company — particularly for due diligence, compliance verification, or monitoring accounts, confirmation statements, charges, and officer appointments. Prefer it over the full company profile endpoint when you specifically need the list of historical filings rather than current registration details.

## Known failure modes

- Invalid or non-existent company number returns an empty result or 404-style error
- company_number not zero-padded may fail to match Companies House records
- limit value outside 1-50 range is rejected with a validation error
- Companies House API downtime causes upstream failure
- Private or dissolved companies may have incomplete or restricted filing histories

## How this service works

Filing history for a UK company from Companies House — accounts, confirmation statements, appointments, charges and other statutory filings.

## Output

A list of filing records (up to 50, most recent first) for the specified UK company, each containing details such as filing type, description, date filed, and links to the underlying documents from Companies House.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum number of filings to return, most recent first (1-50)."
  },
  "company_number": {
   "type": "string",
   "description": "Companies House registration number (zero-padded, e.g. '00445790')."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/companies-house-filing-history-api-acc31f00/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from company.payapi.market](https://www.zero.xyz/host/company.payapi.market/llms.txt)