# UK Companies House Lookup (eu-verify)

> UK Companies House Lookup (eu-verify) is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns official UK Companies House data including company search results, full company profiles, current officers, and PSC (persons with significant control) with risk flags, all in a single paid API call.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/uk/company
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-companies-house-lookup-eu-verify-f00d7491
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o6DeOlMD9LuuH2YveeyA8

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-lookup-eu-verify-f00d7491
```

Example prompt: Can you pull the full Companies House profile for Tesco PLC — company number 00445790 — including its current directors, persons with significant control, and any insolvency history or overdue filing flags?

## When to prefer this

Choose this endpoint when you need authoritative, statutory UK company data in a single call — especially for KYB (know your business), AML compliance, due diligence on UK counterparties, or UBO identification via the PSC register. It consolidates company profile, officers, PSC, and risk flags (insolvency, charges, overdue filings) that would otherwise require multiple Companies House API calls. Prefer it over generic web scraping or third-party aggregators when you need official, minimized statutory register data for a UK entity. The 24h cache makes it cost-effective for repeated lookups on the same company within a day.

## Known failure modes

- Company number not found — returns empty or error if the number does not exist in Companies House
- Search returns no results if the company name query matches nothing
- Malformed company number format — schema expects string like '00445790'
- Payment failure via x402 protocol before data is returned
- Stale data within the 24-hour cache window may not reflect very recent filings
- Rate limiting or quota errors if called excessively

## How this service works

Official UK Companies House data in one paid call. Search: ?q=tesco returns matching companies (number, status, type, incorporation date). Profile: ?number=00445790 returns the full profile PLUS current officers and PSC (persons with significant control, the UK quasi-UBO register): names, roles, natures of control, risk flags (insolvency history, charges, overdue filings) and typed insolvency cases when history exists. Statutory register data, minimized. 24h cache.

## Output

For a search query (?q=), returns a list of matching UK companies with company number, status, type, and incorporation date. For a profile lookup (?number=), returns the full company profile plus current officers (names, roles) and PSC register entries (names, natures of control), enriched with risk flags such as insolvency history, outstanding charges, overdue filings, and typed insolvency cases where applicable. Results are cached for 24 hours.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name to search"
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "description": "Search results (1-10)"
      },
      "number": {
       "type": "string",
       "description": "UK company number for full profile, e.g. 00445790"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-companies-house-lookup-eu-verify-f00d7491/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)