# Oromi UK Business Search

> Oromi UK Business Search is a paid API for AI agents from agents.oromi.co.uk, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Search UK Companies House data by company name or keyword and return matching registered business records

## Facts

- Endpoint: GET https://agents.oromi.co.uk/api/uk-business/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/oromi-uk-business-search-b7fa2182
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SaMnCT1Anj2ilKwpmGWKZ

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 oromi-uk-business-search-b7fa2182
```

Example prompt: Can you search the UK Companies House register for companies matching 'artisan bakery' and show me up to 20 results with their registration numbers and status?

## When to prefer this

Choose this endpoint when you need to search UK-registered businesses by name or keyword against the official Companies House registry, especially in a machine-payable agentic context using the x402 USDC micropayment protocol. Prefer it over scraping Companies House directly or using unofficial sources when you need clean structured JSON output with company number and status. Best for due diligence, supplier verification, market research, and compliance workflows focused specifically on UK entities.

## Known failure modes

- Missing required query parameter 'q' returns a validation error
- Query returns zero results if no companies match the keyword
- Payment failure via x402 protocol returns HTTP 402 with payment details
- Rate limits or quota exhaustion may result in errors
- Very common keywords may return truncated result sets at the max 50 cap

## How this service works

Machine-payable APIs for AI agents, paid per call in USDC via the x402 protocol: UK business data (Companies House), UK property market data (HM Land Registry), website agent-readiness audits, and crypto market context.

## Output

Returns a JSON object containing the search query, total number of matching companies, and an array of up to 50 company records each including company name, company registration number, and active/inactive status.

## 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 or keyword to search"
      },
      "items": {
       "type": "string",
       "description": "Max results (default 10, max 50)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "status": "active",
    "company_name": "ARTISAN BAKERY LTD",
    "company_number": "12345678"
   }
  ],
  "query": "artisan bakery",
  "total_results": 42
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oromi-uk-business-search-b7fa2182/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.oromi.co.uk](https://www.zero.xyz/host/agents.oromi.co.uk/llms.txt)