# RunOnProof UK Company Check

> RunOnProof UK Company Check is a paid API for AI agents from api.runonproof.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Verifies a UK company's legal status and insolvency observations by resolving its Companies House identity in a single paid API call.

## Facts

- Endpoint: POST https://api.runonproof.com/v1/gb/solutions/company-check
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/runonproof-uk-company-check-202d62ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_22XSPT_bU9w3509MsJS6F

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-202d62ff -d '<json body>'
```

Example prompt: Before we onboard them as a supplier, can you run a company check on Acme Widgets Ltd — their Companies House number is 12345678 — and tell me if they're legally active and have any insolvency issues?

## When to prefer this

Use this endpoint when you need a quick, cost-effective single-call check on a UK-registered company's legal and insolvency status before onboarding, contracting, or payment. It is preferable over manual Companies House lookups when you need programmatic verification at scale, and over broader KYB platforms when only UK company status resolution is needed at low per-call cost ($0.04 USDC).

## Known failure modes

- Company not found if name or number does not match any Companies House record
- Ambiguous match if company name resolves to multiple entities — supply company number for precision
- Payment failure if x402 payment is not correctly attached
- Invalid company number format if the number does not match the expected pattern
- Idempotency key mismatch if the key in the body differs from the Idempotency-Key header
- Rate limiting or quota errors if the caller exceeds allowed request volume

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

Returns the resolved Companies House identity for the company, its current legal status, any insolvency observations on record, and applicable filing limit disclosures. Does not guarantee universal good standing but surfaces key risk signals relevant to onboarding or contracting decisions.

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