# x402 Company Search API

> x402 Company Search API is a paid API for AI agents from x402-company-api-production.up.railway.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Search and retrieve company information by name or partial name query, returning up to 50 matching results.

## Facts

- Endpoint: POST https://x402-company-api-production.up.railway.app/company-search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-company-search-api-efb1ff63
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IQrxiavabxtowEO1MSG-8

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 x402-company-search-api-efb1ff63 -d '<json body>'
```

Example prompt: Can you search for companies matching 'Acme' and return up to 10 results?

## When to prefer this

Use this endpoint when you need to search for companies by name or partial name and retrieve structured company data. Prefer this over web search when you need clean, structured company records rather than unstructured web content. Best suited for business intelligence workflows, company lookup, and data enrichment pipelines that require programmatic access to company information.

## Known failure modes

- Query string missing or empty — returns validation error
- Limit exceeds maximum of 50 — returns schema validation error
- No companies found matching the query — returns empty result set
- Service unavailable or Railway deployment down — returns 5xx error
- Payment not fulfilled (x402 protocol) — returns 402 Payment Required

## How this service works

Search UK companies by name via Companies House — returns matches with number, status, type, incorporation date, address.

## Output

A list of up to 50 company records matching the search query, including company names and associated details returned from the company database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Maximum number of matches to return (1-50)."
  },
  "query": {
   "type": "string",
   "description": "Company name (or partial name) to search."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-company-search-api-efb1ff63/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-company-api-production.up.railway.app](https://www.zero.xyz/host/x402-company-api-production.up.railway.app/llms.txt)