# UK Postcode Lookup

> UK Postcode Lookup is a paid API for AI agents from gogeta2-u35175.vm.elestio.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-30).

Returns geographic and administrative metadata for a UK postcode including lat/lon, country, region, local authority, ward, parliamentary constituency, NHS ICB, and police force.

## Facts

- Endpoint: GET https://gogeta2-u35175.vm.elestio.app/agents/v1/geo/uk-postcode?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-postcode-lookup-f9828471
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tVwlq7XcunWI4TQkvdArl

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-f9828471
```

Example prompt: Can you look up the postcode SW1A 2AA and tell me its latitude, longitude, local authority, parliamentary constituency, and which police force covers it?

## When to prefer this

Use this endpoint when you need accurate, ONS-sourced administrative boundary data for UK postcodes, including NHS ICB, police force, and LSOA — metadata that generic geocoding APIs do not provide. Prefer it over raw geocoding services when UK-specific administrative enrichment is the goal, and over manual lookup when automating at scale.

## Known failure modes

- Unknown or invalid postcode returns a not-found response and is not charged
- Malformed postcode string (e.g. missing space, incorrect format) may return an error
- Postcode may be valid but not yet in the ONS directory if very recently assigned

## How this service works

UK postcode lookup (ONS Postcode Directory via postcodes.io): lat/lon, country, region, local authority, ward, parliamentary constituency, NHS ICB, police force, LSOA. Unknown postcode = not charged.

## Output

Returns structured geographic and administrative data for the given UK postcode including: latitude and longitude, country, region, local authority district, ward, parliamentary constituency, NHS Integrated Care Board (ICB), police force area, and LSOA code. If the postcode is unknown or invalid, the request is not charged.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "postcode"
     ],
     "properties": {
      "postcode": {
       "type": "string",
       "description": "UK postcode, e.g. SW1A 2AA"
      }
     }
    }
   },
   "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/uk-postcode-lookup-f9828471/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gogeta2-u35175.vm.elestio.app](https://www.zero.xyz/host/gogeta2-u35175.vm.elestio.app/llms.txt)