# RunOnProof UK Company Check

> RunOnProof UK Company Check is a paid API for AI agents from cdo-production.up.railway.app, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Resolves a UK company's Companies House identity and verifies its current legal status and insolvency observations in a single paid call.

## Facts

- Endpoint: POST https://cdo-production.up.railway.app/v1/gb/solutions/company-check
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/runonproof-uk-company-check-eec021ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9rTanZIgu9vW8XU-4_XD4

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 runonproof-uk-company-check-eec021ac -d '<json body>'
```

Example prompt: Before we sign a contract with Acme Widgets Ltd, can you check their UK Companies House status and flag any insolvency issues — their company number is 12345678?

## When to prefer this

Choose this endpoint when you need a fast, single-call check of a UK company's Companies House identity and insolvency status before onboarding a supplier, signing a contract, or extending credit. It is purpose-built for UK entities and uses Companies House as its authoritative source. Prefer it over generic company data APIs when you need insolvency observations specifically and want a pay-per-call model with no subscription. Not suited for non-UK companies (use the Brazilian company endpoints on the same platform for LATAM entities) or for full financial credit scoring.

## Known failure modes

- Company not found — no Companies House record matches the provided number, name, or postal code
- Invalid company number format — input does not match the required pattern (6–8 digits, optional 2-letter prefix)
- Ambiguous match — company name resolves to multiple entities without a disambiguating number or postal code
- Insolvency data unavailable — Companies House filing gaps may result in incomplete insolvency observations
- Payment failure — the $0.04 USDC charge via x402 is declined or wallet has insufficient funds
- Idempotency key collision — a mismatched idempotency key resubmission may return a cached or rejected result

## How this service works

Check a UK company by resolving its Companies House identity and verifying current legal-status and insolvency observations in one paid call. Use before onboarding or contracting. It reports filing limits and does not promise universal good standing.

## Output

The endpoint returns the resolved Companies House identity for the UK company (matched by number, name, or postal code), its current legal status (e.g. active, dissolved, struck off), and any insolvency observations (e.g. liquidation, administration, receivership). It also notes filing limits and scope caveats, clarifying that the result does not constitute a universal good-standing certificate.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "postal_code": {
   "type": "string",
   "maxLength": 20
  },
  "company_name": {
   "type": "string",
   "maxLength": 300,
   "minLength": 2
  },
  "company_number": {
   "type": "string",
   "pattern": "^(?:(?:[A-Z]{2}|[0-9]{2})?[0-9]{6}|[0-9]{8})$",
   "description": "Companies House company number, including any two-letter prefix when applicable."
  },
  "idempotency_key": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]{8,120}$",
   "description": "Caller-generated key. Send the identical value in the Idempotency-Key header."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/runonproof-uk-company-check-eec021ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cdo-production.up.railway.app](https://www.zero.xyz/host/cdo-production.up.railway.app/llms.txt)