# RunOnProof UK Invoice Company Match

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

Compares UK invoice identity fields (company name, registered postcode) against Companies House records to detect mismatches before payment

## Facts

- Endpoint: POST https://cdo-production.up.railway.app/v1/gb/invoices/match-company
- Price: $0.05/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-invoice-company-match-e53c145e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BJ35oNo7JkI_bDtYTA6WS

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-invoice-company-match-e53c145e -d '<json body>'
```

Example prompt: Before we pay this invoice from Acme Logistics Ltd, company number 12345678, with a registered postcode of SW1A 1AA — can you cross-check those details against Companies House and flag any name or postcode mismatches?

## When to prefer this

Use this endpoint when you have a UK supplier invoice and want to detect company-name or registered-postcode mismatches against the public Companies House registry before approving payment. Prefer this over full due-diligence endpoints when you only need lightweight identity-field matching rather than sanctions screening or full corporate graph analysis. It is not a substitute for VAT verification or proof of invoice authenticity.

## Known failure modes

- Company number not found at Companies House — returns mismatch or unknown result
- Invalid company number format — request rejected with validation error
- Postcode not on record at Companies House — field returned as UNKNOWN
- VAT number provided but not independently verified — noted in response
- Missing required invoice_company_name — request rejected
- Idempotency key conflict if reused with different payload

## How this service works

Compare UK invoice identity fields with Companies House before payment. Use to detect company-name or registered-postcode mismatches. This does not prove invoice authenticity or VAT registration, and UNKNOWN fields remain explicit.

## Output

Returns a structured match result indicating whether the invoice company name and registered postcode align with Companies House records, with explicit UNKNOWN flags for fields that could not be verified. Does not confirm VAT registration or invoice authenticity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vat_number": {
   "type": "string",
   "maxLength": 20,
   "description": "Optional UK VAT number; this route does not independently verify VAT registration."
  },
  "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."
  },
  "invoice_address": {
   "type": "object",
   "properties": {
    "line_1": {
     "type": "string",
     "maxLength": 300
    },
    "line_2": {
     "type": "string",
     "maxLength": 300
    },
    "country": {
     "type": "string",
     "maxLength": 80
    },
    "locality": {
     "type": "string",
     "maxLength": 200
    },
    "postal_code": {
     "type": "string",
     "maxLength": 20
    }
   },
   "additionalProperties": false
  },
  "invoice_company_name": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1,
   "description": "Legal name printed on the invoice."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/runonproof-uk-invoice-company-match-e53c145e/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)