# Celer API UK Companies House Search

> Celer API UK Companies House Search is a paid API for AI agents from www.celerapi.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Search UK Companies House registry by company name and retrieve company records

## Facts

- Endpoint: GET https://www.celerapi.com/v1/company/search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/celer-api-uk-companies-house-search-0a80d30c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LIEPeDdGUHaedLH5jp6tW

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 celer-api-uk-companies-house-search-0a80d30c
```

Example prompt: Can you search UK Companies House for 'Acme Technologies Ltd' and tell me what comes up?

## When to prefer this

Use this endpoint when you need to search the UK Companies House registry by company name. It is ideal for agent workflows requiring UK company verification, due diligence, contract preparation, or business identity confirmation. Prefer this over generic web search when you need structured, authoritative company registration data from the official UK government registry.

## Known failure modes

- Empty query string returns validation error
- No matching companies found returns empty data array
- Companies House API unavailability may cause incomplete results indicated by complete:false flag
- Query too long (over 200 characters) rejected by schema validation
- Network timeout or upstream provider error

## How this service works

Search authoritative company registries by company name to resolve candidate legal entities and registration identifiers. Currently supports the United Kingdom (GB) and Norway (NO), with expanding jurisdiction coverage. Results are public-register evidence, not a KYC or KYB compliance determination.

## Output

Returns a structured response including success status, completeness flag, an array of matching company records from UK Companies House, entity ID, provenance metadata describing the data source, and any warnings. The data field contains the actual company search results.

## 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",
       "maxLength": 200,
       "minLength": 1,
       "description": "Company or business name to search in the selected authoritative company registry."
      },
      "country": {
       "enum": [
        "GB",
        "NO"
       ],
       "type": "string",
       "default": "GB",
       "description": "ISO alpha-2 country hint; omission defaults to GB."
      },
      "jurisdiction": {
       "type": "string",
       "pattern": "^[A-Za-z0-9-]{2,32}$",
       "description": "Optional sub-jurisdiction hint."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "complete",
      "entity_ids",
      "data",
      "provenance",
      "warnings"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "entity_id",
         "legal_name",
         "company_number",
         "registration_number",
         "country",
         "jurisdiction",
         "source",
         "available_capabilities"
        ],
        "properties": {
         "source": {
          "type": "object",
          "required": [
           "authority",
           "provider"
          ],
          "properties": {
           "provider": {
            "type": "string"
           },
           "authority": {
            "type": "string"
           }
          }
         },
         "status": {
          "type": "string"
         },
         "country": {
          "type": "string",
          "pattern": "^[A-Z]{2}$"
         },
         "entity_id": {
          "type": "string",
          "example": "gb:companies-house:09446231"
         },
         "legal_name": {
          "type": "string"
         },
         "match_type": {
          "enum": [
           "exact",
           "prefix"
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "source": {
     "provider": "companies_house",
     "authority": "UK Companies House"
    },
    "country": "GB",
    "entity_id": "gb:companies-house:09446231",
    "legal_name": "MONZO BANK LIMITED",
    "jurisdiction": "GB",
    "company_number": "09446231",
    "registration_number": "09446231",
    "available_capabilities": [
     "profile",
     "officers",
     "owners",
     "filings",
     "insolvency"
    ]
   }
  ],
  "success": true,
  "complete": true,
  "warnings": [],
  "entity_ids": [
   "gb:companies-house:09446231"
  ],
  "provenance": {
   "source": "UK Companies House",
   "registry": "companies_house",
   "freshness": "live",
   "jurisdiction": "GB",
   "retrieved_at": "2026-08-26T00:00:00.000Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/celer-api-uk-companies-house-search-0a80d30c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.celerapi.com](https://www.zero.xyz/host/www.celerapi.com/llms.txt)