# Oromi UK Business Search

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

Search the UK Companies House registry by company name or keyword and return matching company records including status and company number.

## Facts

- Endpoint: GET https://oromi-agent-services.onrender.com/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-d63607d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VixL2moulGyTOiCK0RQvP

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-d63607d6
```

Example prompt: Can you search Companies House for UK companies matching 'artisan bakery' and return up to 20 results with their company numbers and status?

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-call access to UK Companies House data without setting up your own API key or OAuth flow with Companies House directly. Ideal for AI agents that need to verify UK business registrations, look up company numbers, or check company status on demand, and can pay micro-amounts in USDC via x402. Prefer this over scraping or manual lookup when operating in an automated pipeline.

## Known failure modes

- Missing required query parameter 'q' returns a validation error
- No matching companies found returns an empty items array with total_results 0
- Payment failure via x402 protocol blocks access and returns HTTP 402
- Render hosting cold-start may cause slow initial response or timeout
- Overly generic search keyword may return up to 50 results with low relevance

## 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

A JSON array of matching company records, each containing the company name, company number, and current status (e.g. active or dissolved), along with the original query string and total number of results found in the registry.

## 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-d63607d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oromi-agent-services.onrender.com](https://www.zero.xyz/host/oromi-agent-services.onrender.com/llms.txt)