# Suverse UK Postcode Lookup

> Suverse UK Postcode Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-16).

Looks up a UK postcode via Postcodes.io and returns latitude, longitude, district, region, and administrative area data — no API key required.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-uk-postcode
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-uk-postcode-lookup-1e365bcf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_En1qfV1EoLbKYzn5tLewS

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 suverse-uk-postcode-lookup-1e365bcf -d '<json body>'
```

Example prompt: Can you look up the postcode EC1A 1BB and tell me its latitude, longitude, district, and region?

## When to prefer this

Choose this endpoint when you need to validate or enrich UK postcodes with geographic and administrative metadata without managing your own Postcodes.io integration or API key. Ideal for AI agents handling UK address validation, delivery routing, or location-based enrichment in automated workflows where per-call micro-payment (x402) billing is acceptable.

## Known failure modes

- Invalid or malformed postcode returns an error or empty result
- Terminated/non-live postcodes may not be found in Postcodes.io
- Network or proxy timeout if the upstream Postcodes.io API is unavailable
- Payment failure (x402) if the $0.002 USDC transaction cannot be processed
- Missing or incorrect 'input' body structure returns a validation error

## How this service works

Look up a UK postcode from Postcodes.io, no key. Returns the latitude, longitude, district, region, and administrative areas. For AI agents validating and enriching UK addresses.

## Output

Returns a JSON object containing the postcode's latitude, longitude, administrative district, region name, and other UK administrative area fields sourced from Postcodes.io.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-uk-postcode-lookup-1e365bcf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)