# UK Postcode Address Lookup

> UK Postcode Address Lookup is a paid API for AI agents from postcode.payapi.market, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-30).

Searches UK postcodes by free-text address or place query, returning full postcode metadata including coordinates, administrative regions, and constituency data.

## Facts

- Endpoint: POST https://postcode.payapi.market/lookup/address?utm_source=zero.xyz
- Price: $0.001/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-address-lookup-206406a6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0WxxUFbmnawTX-hNefTUp

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-address-lookup-206406a6 -d '<json body>'
```

Example prompt: What's the postcode for Buckingham Palace, and can you give me up to 5 results with their coordinates and administrative details?

## When to prefer this

Choose this endpoint when you need to resolve a free-text UK address or place name into structured postcode metadata, especially when you also need administrative boundary data (ward, district, constituency, NHS CCG) or precise coordinates. Prefer it over a simple postcode validator when the input is a place name rather than a known postcode string, and when enrichment with geographic and administrative codes is required.

## Known failure modes

- No matching postcodes found for vague or misspelled query — returns empty results array with count 0
- Query too broad returns up to the requested limit but may miss the intended postcode
- Non-UK addresses return no results
- Payment failure via x402 protocol prevents call from completing
- Limit parameter out of range (below 1 or above 100) causes validation error

## How this service works

UK postcode lookup, search, validation and autocomplete with x402 payments.

## Output

Returns a JSON object with a count of results and an array of postcode records, each containing the full postcode, incode/outcode, latitude, longitude, region, country, admin district, admin ward, parish, parliamentary constituency, CCG, LSOA, MSOA, NUTS area, European electoral region, and ONS codes for administrative units.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of matching postcodes to return (1-100, default 10)."
  },
  "query": {
   "type": "string",
   "description": "Free-text address or place query to match against UK postcodes."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "Buckingham Palace",
  "results": [
   {
    "ccg": "NHS North West London",
    "lsoa": "Westminster 018C",
    "msoa": "Westminster 018",
    "nuts": "Westminster",
    "codes": {
     "admin_ward": "E05013806",
     "admin_district": "E09000033"
    },
    "incode": "1AA",
    "parish": "Westminster, unparished area",
    "region": "London",
    "country": "England",
    "outcode": "SW1A",
    "quality": 1,
    "latitude": 51.501009,
    "postcode": "SW1A 1AA",
    "longitude": -0.141588,
    "admin_ward": "St James's",
    "admin_county": null,
    "admin_district": "Westminster",
    "primary_care_trust": "Westminster",
    "date_of_introduction": "198001",
    "european_electoral_region": "London",
    "parliamentary_constituency": "Cities of London and Westminster"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-postcode-address-lookup-206406a6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from postcode.payapi.market](https://www.zero.xyz/host/postcode.payapi.market/llms.txt)