# UK Company Lookup by Number

> UK Company Lookup by Number is a paid API for AI agents from x402-farm.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Retrieves UK company name and status by company number from Companies House data via a pay-per-call x402 API

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/uk/company
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-company-lookup-by-number-d455fcdc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q5P6D2696fgBVL6y5aV74

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-lookup-by-number-d455fcdc
```

Example prompt: Can you look up UK company number 00445790 and tell me the registered name and whether it's still active?

## When to prefer this

Use this endpoint when you need to verify or enrich UK company identity using a Companies House registration number, especially in due diligence, KYC, supplier verification, or compliance workflows. It requires no account setup and charges per call via USDC on Base, making it ideal for low-volume or agent-driven lookups without API key management overhead. Prefer this over full Companies House API integration when you only need name and status fields and want frictionless pay-per-use access.

## Known failure modes

- Invalid or non-existent company number returns an error or empty result
- Company number formatted incorrectly (e.g. missing leading zeros) may not match
- Dissolved or struck-off companies may return a non-active status rather than an error
- Payment failure via x402/USDC results in a 402 response before data is returned
- Rate limits or network issues may cause transient failures

## How this service works

Pay-per-call APIs for AI agents — x402 protocol, USDC on Base, no account needed.

## Output

Returns a JSON object containing the company's registered name (e.g. 'TESCO PLC'), its current status (e.g. 'active'), and the company number used for the lookup. Useful for verifying corporate identity and registration status against the UK Companies House registry.

## 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": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "TESCO PLC",
  "status": "active",
  "company_number": "00445790"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-company-lookup-by-number-d455fcdc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-farm.vercel.app](https://www.zero.xyz/host/x402-farm.vercel.app/llms.txt)