# CelerAPI — UK Company Filings Lookup

> CelerAPI — UK Company Filings Lookup is a paid API for AI agents from www.celerapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Retrieves a list of recent Companies House filing records for a specific UK-registered company by company number.

## Facts

- Endpoint: GET https://www.celerapi.com/v1/company/%7BcompanyNumber%7D/filings?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/celerapi-uk-company-filings-lookup-c4d58a7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VheTuTmbiIOWe2RvNOJ2F

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 celerapi-uk-company-filings-lookup-c4d58a7b
```

Example prompt: Can you pull up the 10 most recent Companies House filings for UK company number 09446231? I want to see what they've submitted recently.

## When to prefer this

Use this endpoint when you need the filing history of a specific UK company and already have the company number (e.g. retrieved from a prior company search). It's ideal for due diligence, compliance checking, investor research, or monitoring a company's regulatory submissions. Prefer this over general web scraping when you need structured, live data directly from the authoritative UK Companies House registry.

## Known failure modes

- Invalid company number format (must be 8 alphanumeric characters) returns a validation error
- Company number not found in Companies House registry returns no data or an empty result
- Payment failure via x402 protocol results in 402 response and no data returned
- Rate limiting or upstream Companies House API unavailability may cause timeouts or errors
- Requesting a limit outside the 1–100 range returns a validation error

## How this service works

Resolve companies, legal entities and financial reference data using authoritative sources. Machine-native, pay per request, no subscription.

## Output

Returns a structured JSON object containing a list of recent Companies House filing records for the specified company, including filing types, dates, and document references. Also includes provenance metadata indicating the data comes live from UK Companies House, plus success/completeness flags and any warnings.

## 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": [
      "companyNumber"
     ],
     "properties": {
      "companyNumber": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{8}$",
       "description": "UK Companies House registration number, typically returned by search_company. Example: 09446231."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 100,
       "minimum": 1,
       "description": "Maximum number of recent Companies House filing records to return."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "complete",
      "data",
      "provenance",
      "warnings"
     ],
     "properties": {
      "data": {},
      "success": {
       "type": "boolean"
      },
      "complete": {
       "type": "boolean"
      },
      "warnings": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "entity_id": {
       "type": "string"
      },
      "provenance": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true,
  "complete": true,
  "warnings": [],
  "provenance": {
   "source": "UK Companies House",
   "registry": "companies_house",
   "freshness": "live",
   "jurisdiction": "GB"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/celerapi-uk-company-filings-lookup-c4d58a7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.celerapi.com](https://www.zero.xyz/host/www.celerapi.com/llms.txt)