# Agent402 UK Company Number Format Validator

> Agent402 UK Company Number Format Validator is a paid API for AI agents from agent402.co.uk, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Normalises and validates UK Companies House company number format (zero-padding and SC/NI prefix handling) using pure logic, without performing a live register lookup.

## Facts

- Endpoint: POST https://agent402.co.uk/v1/validate/uk-company-number
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-uk-company-number-format-validator-68ca88f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yrrn2GjM0awxUzDS-CMmn

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 agent402-uk-company-number-format-validator-68ca88f0 -d '<json body>'
```

Example prompt: Can you check whether '123456' is a valid UK Companies House number and give me the correctly formatted version?

## When to prefer this

Use this endpoint when you need to sanitise or normalise a raw UK company number string before passing it downstream to a paid Companies House profile lookup — it costs a fraction of a live lookup and catches formatting errors (missing zero-pads, wrong case, unknown prefixes) without consuming credits on a live register call. Prefer this over client-side regex when you need canonical normalisation logic with jurisdiction hint output.

## Known failure modes

- Malformed or empty input string returns valid_format: false
- Prefix not recognised as a known UK jurisdiction prefix returns invalid
- No live register check performed — a well-formatted but non-existent number still returns valid_format: true
- Very long or obviously non-numeric strings without a valid prefix treated as invalid

## How this service works

Don't burn tokens on deterministic work. Go/no-go jobs first: payout preflight, text firewall (PII/secrets), budget check — then rails, calendars, finmath. x402 USDC on Base. UK + global. agent402.co.uk — not agent402.tools. $0.001–$0.002 USDC on Base. No API keys.

## Output

Returns a JSON object indicating whether the input is a valid Companies House number format (valid_format boolean), the normalised/zero-padded company number string, and a jurisdiction_hint (e.g. 'england-wales', 'scotland', 'northern-ireland') inferred from any prefix.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "company_number": {
   "type": "string",
   "description": "Company number (digits or SC/NI/… prefix)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "valid_format": true,
  "company_number": "00123456",
  "jurisdiction_hint": "england-wales"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-uk-company-number-format-validator-68ca88f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.co.uk](https://www.zero.xyz/host/agent402.co.uk/llms.txt)