# UK Postcode Lookup

> UK Postcode Lookup is a paid API for AI agents from anibalb.duckdns.org, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-31).

Returns geographic and administrative data for a UK postcode, including coordinates, NHS health authority, region, and country.

## Facts

- Endpoint: GET https://anibalb.duckdns.org/x402/uk-postcode?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-postcode-lookup-f5ff7296
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zg1vXxTq-I4sQXr0xxAih

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 uk-postcode-lookup-f5ff7296
```

Example prompt: Can you look up the geographic details for the UK postcode SW1A 1AA — I need the coordinates, region, and which NHS health authority it falls under?

## When to prefer this

Use this endpoint when you need lightweight, pay-per-call UK postcode geocoding and administrative data without requiring an API key or account. Ideal for agents that handle sporadic lookups and want to pay in USDC via x402 rather than managing subscription credentials.

## Known failure modes

- Invalid or non-existent postcode returns an error or empty result
- Postcode not found in database (e.g. recently assigned or terminated postcodes)
- Payment failure via x402 prevents access to the response
- Rate limiting or network timeout on the duckdns host

## How this service works

Public data and utility APIs paid per call in USDC on Base (x402). No accounts, no API keys. 174 routes: crypto/equity data, onchain reads, DNS/email/security intel, geo/weather, x402 payment diagnostics, dev utilities and more.

## Output

A JSON object containing the postcode, latitude, longitude, region, country, and NHS health authority (nhs_ha) for the queried UK postcode.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "nhs_ha": "London",
  "region": "London",
  "country": "England",
  "latitude": 51.50101,
  "postcode": "SW1A 1AA",
  "longitude": -0.141563
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-postcode-lookup-f5ff7296/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from anibalb.duckdns.org](https://www.zero.xyz/host/anibalb.duckdns.org/llms.txt)