# UK Companies House Registry Lookup

> UK Companies House Registry Lookup is a paid API for AI agents from companies.use.x402atlas.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Looks up a UK company by registration number or name in the official Companies House register, returning legal details in a normalized schema.

## Facts

- Endpoint: GET https://companies.use.x402atlas.com/uk-company-data?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-companies-house-registry-lookup-51fce0ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3eneQTgFfYo5U09J_JU9J

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-companies-house-registry-lookup-51fce0ba
```

Example prompt: Can you look up the UK Companies House record for Rolls-Royce Holdings — I need their registration number, current status, registered address, and SIC codes?

## When to prefer this

Use this endpoint when you need authoritative, official UK company data from Companies House — particularly when verifying legal existence, checking active status, or retrieving the official registered address and company number. Prefer this over generic business search APIs when regulatory compliance, due diligence, or KYC accuracy is required. It uses a normalized cross-country schema, making it easy to combine with sibling endpoints for other European registries.

## Known failure modes

- No matching company found — returns count:0 and an empty companies array with a note
- Invalid or malformed company number format — may return zero results
- Company name query returns multiple matches — all are returned but caller must disambiguate
- Companies House API downtime — upstream service unavailable error
- Query string too long (over 200 characters) — rejected by schema validation

## How this service works

UK company lookup in the official Companies House register by company number or company name. Returns legal name, company status, company type, incorporation date, registered office address and SIC codes in a schema shared across countries.

## Output

Returns a normalized JSON object containing: the echoed query, ISO country code (GB), registry name (Companies House), match count, and an array of matched companies each with legal name, registration number, normalized status (active/inactive/unknown), legal form, incorporation date, registered office address (street, city, postal code, country code), SIC activity codes, and website if available.

## 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",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 200,
       "description": "Company registration number (UK company number, e.g. 00445790) or company name"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "registry",
      "query",
      "matched_by",
      "count",
      "companies"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Hint present only on the sample response (empty/omitted query) and on a zero-match response"
      },
      "count": {
       "type": "integer",
       "description": "Number of entries in companies"
      },
      "query": {
       "type": "string",
       "description": "Echoed query (trimmed)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 code of the route's country"
      },
      "registry": {
       "type": "string",
       "description": "Official registry the result comes from"
      },
      "companies": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "name",
         "registration_number",
         "status",
         "legal_form",
         "founded",
         "address",
         "activities",
         "website"
        ],
        "properties": {
         "name": {
          "type": "string",
          "description": "Current legal name"
         },
         "status": {
          "enum": [
           "active",
           "inactive",
           "unknown"
          ],
          "type": "string",
          "description": "Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown"
         },
         "address": {
          "type": "object",
          "required": [
           "street",
           "postal_code",
           "city
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-companies-house-registry-lookup-51fce0ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companies.use.x402atlas.com](https://www.zero.xyz/host/companies.use.x402atlas.com/llms.txt)