# UK Data API – Company Search

> UK Data API – Company Search is a paid API for AI agents from uk-data.agent-fee-check.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-12).

Search for UK companies by name using Companies House data, returning registration details, status, type, and registered office address.

## Facts

- Endpoint: GET https://uk-data.agent-fee-check.workers.dev/company-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-data-api-company-search-3164498e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7nHAKzmsqojmqJ-uwrS3x

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-data-api-company-search-3164498e
```

Example prompt: Can you search Companies House for 'Tesco' and show me the registration details, company number, and registered address for the results?

## When to prefer this

Use this endpoint when you need to search UK companies by name via Companies House data in a single pay-per-call API without setting up a full Companies House API key. Ideal for agents needing quick due diligence, supplier verification, or business lookup within a broader UK data workflow. Prefer over direct Companies House API when you want attribution included, pay-per-use pricing, and unified access alongside other UK data types.

## Known failure modes

- No results found for obscure or misspelled company names
- Payment required (402) if no x402 payment is provided — a free preview sample is returned
- Rate limiting or upstream Companies House API unavailability
- Query parameter 'q' missing returns a 400 or error response
- Very common search terms may return large result sets with limited filtering

## How this service works

UK public data for AI agents, one origin, pay per call: a one-call postcode report, street crime, live flood warnings, property sales and the House Price Index, food hygiene ratings, MP lookup, NHS GPs, pharmacies and dentists, Companies House checks and search, UK working days and bank holidays, and the cheapest card machine provider. Official sources, attribution in every answer, free preview in every 402, failed requests never charged.

## Output

Returns a JSON array of matching companies, each with company name, company number, company type (e.g. ltd, plc), active/ceased status, cessation date if applicable, incorporation date, and registered office address. Attribution to Companies House is included in the response.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name to search for"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "type": "plc",
    "status": "active",
    "ceased_on": null,
    "company_name": "TESCO PLC",
    "company_number": "00445790",
    "incorporated_on": "1947-11-27",
    "registered_office": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA"
   },
   {
    "type": "ltd",
    "status": "active",
    "ceased_on": null,
    "company_name": "KFORD TYRES (GORNAL) LTD",
    "company_number": "09384423",
    "incorporated_on": "2015-01-12",
    "registered_office": "2 Dawley Brook Road, Kingswinford, England, DY6 7BD"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-data-api-company-search-3164498e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from uk-data.agent-fee-check.workers.dev](https://www.zero.xyz/host/uk-data.agent-fee-check.workers.dev/llms.txt)