# UK Data API – Companies House Lookup by Number

> UK Data API – Companies House Lookup by Number is a paid API for AI agents from uk-data.agent-fee-check.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-31).

Returns structured company profile data from Companies House for a given UK company registration number, including status, officers, filings, charges, and insolvency history.

## Facts

- Endpoint: GET https://uk-data.agent-fee-check.workers.dev/company/%7Bnumber%7D?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-data-api-companies-house-lookup-by-number-f31a3e94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oat1Yw5eKwnkdQa_TFSuH

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-data-api-companies-house-lookup-by-number-f31a3e94
```

Example prompt: Can you look up UK company number 00445790 on Companies House and tell me if it's active, when it was incorporated, whether there are any charges registered, and if its accounts are up to date?

## When to prefer this

Choose this endpoint when you need a single, structured, attribution-ready Companies House profile for a specific UK company number in one call, without building your own Companies House API integration. Prefer it over raw Companies House API access when you want pay-per-call pricing with no subscription, guaranteed attribution, and a human-readable summary alongside structured data. It is ideal for AI agents performing due diligence, compliance checks, or business verification as part of a broader UK data workflow.

## Known failure modes

- Company number not found – returns error if the number does not exist in Companies House
- Invalid company number format – malformed input may return a 400-level error
- Payment required (402) – if no valid x402 payment header is provided, returns a free preview with the 402 response
- Upstream Companies House API unavailable – may return 503 or timeout
- Rate limiting – excessive requests may be throttled

## How this service works

UK public data for AI agents, one origin, pay per call: a one-call postcode report, street crime, live flood warnings, property sales and the House Price Index, food hygiene ratings, MP lookup, NHS GPs, pharmacies and dentists, Companies House checks and search, UK working days and bank holidays, and the cheapest card machine provider. Official sources, attribution in every answer, free preview in every 402, failed requests never charged.

## Output

A JSON object containing the company's name, number, type (e.g. plc, ltd), active/dissolved status, incorporation date, jurisdiction, registered office address, SIC codes, number of active officers, accounts filing dates and overdue status, confirmation statement due dates, whether charges are registered, insolvency history flag, and a pre-formatted human-readable summary string with attribution. A free preview is included in 402 responses; failed requests are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "plc",
  "flags": [
   "charges_registered"
  ],
  "status": "active",
  "summary": "TESCO PLC (00445790) is active, incorporated 1947-11-27. Filings are up to date. Checked 2026-10-11.",
  "accounts": {
   "overdue": false,
   "next_due": "2027-08-26",
   "last_made_up_to": "2026-02-28"
  },
  "ceased_on": null,
  "sic_codes": [
   "47110"
  ],
  "company_name": "TESCO PLC",
  "jurisdiction": "england-wales",
  "company_number": "00445790",
  "active_officers": 11,
  "incorporated_on": "1947-11-27",
  "registered_office": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA, United Kingdom",
  "charges_registered": true,
  "insolvency_history": false,
  "confirmation_statement": {
   "overdue": false,
   "next_due": "2027-07-02"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-data-api-companies-house-lookup-by-number-f31a3e94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uk-data.agent-fee-check.workers.dev](https://www.zero.xyz/host/uk-data.agent-fee-check.workers.dev/llms.txt)