# 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-10).

Look up UK companies by registration number or name in the official Companies House register, returning legal details and registered office information.

## Facts

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

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-dbc3dfc2
```

Example prompt: Can you look up UK company number 00445790 in Companies House and tell me its legal name, current status, registered address, and what SIC codes it has?

## When to prefer this

Choose this endpoint when you need authoritative, structured UK company data directly from the official Companies House register — particularly for due diligence, KYC/AML compliance, invoice verification, or enriching CRM records with legal entity details. It uses a normalized schema shared across countries, making it ideal when building multi-country company lookup pipelines alongside sibling endpoints for Norway, Finland, France, Belgium, and Czech Republic.

## Known failure modes

- No company found for the given name or number — returns count 0 with a note field
- Ambiguous company name returns multiple results requiring further disambiguation
- Invalid or malformed company number returns zero matches
- Network or upstream Companies House API unavailability causes request failure
- Query exceeds 200 character limit causing schema validation error

## 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 JSON object containing: the echoed query, country code (GB), registry name, 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 field.

## 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-dbc3dfc2/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)