# Citiview UK Company Filing History

> Citiview UK Company Filing History is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-14).

Retrieves UK company filing history with direct PDF links, secured charges, and insolvency cases from Companies House data

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/uk/filings?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-uk-company-filing-history-bbd9d5fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VfDthNuQvWYfHLar0ZCok

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 citiview-uk-company-filing-history-bbd9d5fa
```

Example prompt: Pull the filing history for UK company number 09624414 — I need the last 10 filings, especially any accounts and confirmation statements, with links to the actual PDFs.

## When to prefer this

Use this endpoint when you need structured access to UK Companies House filing data with direct PDF links, particularly for due diligence, compliance checks, or verifying the financial health and legal standing of a UK-registered company. Prefer this over a general web search when you need machine-readable filing metadata with document links rather than summaries. Best suited for tasks requiring specific filing categories like accounts, charges, or insolvency records.

## Known failure modes

- Company number not found — returns empty results or 404 if the company does not exist on Companies House
- Invalid category value — may return an error or empty set if the category string does not match allowed enum values
- No filings in requested category — returns empty array if company has no filings of that type
- Rate limiting or payment failure — x402 payment may fail or be rejected
- Name search ambiguity — searching by name rather than number may return multiple or no matches

## How this service works

UK company filing history with direct PDF links to each document (accounts, confirmation statements, officer changes), plus secured charges (lenders, outstanding or satisfied) and any insolvency cases. Filter by category.

## Output

A list of filing records for the specified UK company, each including the document type (accounts, confirmation statement, officer change, charge, insolvency, etc.), filing date, description, and a direct PDF download link. Secured charges include lender name and status (outstanding or satisfied). Insolvency cases include case type and relevant dates.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "name": {
       "type": "string"
      },
      "limit": {
       "type": "integer"
      },
      "number": {
       "type": "string",
       "description": "Company number"
      },
      "category": {
       "type": "string",
       "description": "accounts, confirmation-statement, officers, capital, charges, incorporation, insolvency, address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

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