# UK Companies House Company Search

> UK Companies House Company Search is a paid API for AI agents from property.payapi.market, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-17).

Searches UK Companies House for company records matching a free-text query, returning names, addresses, company numbers, and statuses.

## Facts

- Endpoint: POST https://property.payapi.market/company-search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-companies-house-company-search-cb9759d3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m8hBPfdQMuhOuhGKRJGNj

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-company-search-cb9759d3 -d '<json body>'
```

Example prompt: Can you search UK Companies House for 'Tesco' and return up to 5 matching companies with their company numbers, registered addresses, and active status?

## When to prefer this

Choose this endpoint when you need to search UK Companies House records by company name and retrieve official registration data including company numbers, addresses, and status. It is the right choice for due diligence, supplier verification, corporate research, or finding official company identifiers for UK entities. Prefer it over generic web searches when you need structured, authoritative Companies House data with a known schema.

## Known failure modes

- Empty results array if no companies match the query string
- Query too vague returning irrelevant results up to the limit
- Rate limiting or payment failure via x402 protocol returning a 402 status
- Limit parameter out of range (must be 1–50) causing a validation error
- Stale or incomplete Companies House data for recently incorporated or dissolved companies

## How this service works

Production API for UK sold prices, rental yields, and stamp duty. Paid via x402 protocol. Designed for AI agent consumption.

## Output

A JSON object containing the original query, total number of results found, and an array of matching company records each with: company title, registered address, Companies House number, company status (e.g. active, dissolved), and date of creation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Max matches to return. Defaults to 10."
  },
  "query": {
   "type": "string",
   "description": "Free-text query against UK Companies House."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "Tesco",
  "results": [
   {
    "title": "TESCO PLC",
    "address": "Tesco House, Shire Park, Welwyn Garden City",
    "company_number": "00445790",
    "company_status": "active",
    "date_of_creation": "1947-11-27"
   },
   {
    "title": "TESCO STORES LIMITED",
    "address": "Tesco House, Welwyn Garden City",
    "company_number": "02406289",
    "company_status": "active",
    "date_of_creation": "1989-08-04"
   }
  ],
  "total_results": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-companies-house-company-search-cb9759d3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from property.payapi.market](https://www.zero.xyz/host/property.payapi.market/llms.txt)