U

Up · Lookup Nearest

by Up

POSTBase

$0.001

per call · USD Coin on Base

Find UK postcodes within a radius (100-2000m) of a lat/lng, each with its distance in metres from the query point.

Endpoint

POST https://postcode-api-production.up.railway.app/lookup/nearest

2

Calls / 30d

1

Unique payers / 30d

Aug 28

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://postcode-api-production.up.railway.app/lookup/nearest", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "lat": 51.5014,
    "limit": 10,
    "lng": -0.1419,
    "radius": 1000
  }),
});
const data = await res.json();
cURL
curl -X POST \
  "https://postcode-api-production.up.railway.app/lookup/nearest" \
  -H "Content-Type: application/json" \
  -d '{"lat":51.5014,"limit":10,"lng":-0.1419,"radius":1000}' \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "count": 1,
  "lat": 51.5014,
  "lng": -0.1419,
  "radius_m": 1000,
  "results": [
    {
      "admin_county": null,
      "admin_district": "Westminster",
      "admin_ward": "St James's",
      "ccg": "NHS North West London",
      "codes": {
        "admin_district": "E09000033",
        "admin_ward": "E05013806"
      },
      "country": "England",
      "date_of_introduction": "198001",
      "distance_m": 42.7,
      "european_electoral_region": "London",
      "incode": "1AA",
      "latitude": 51.501009,
      "longitude": -0.141588,
      "lsoa": "Westminster 018C",
      "msoa": "Westminster 018",
      "nuts": "Westminster",
      "outcode": "SW1A",
      "parish": "Westminster, unparished area",
      "parliamentary_constituency": "Cities of London and Westminster",
      "postcode": "SW1A 1AA",
      "primary_care_trust": "Westminster",
      "quality": 1,
      "region": "London"
    }
  ]
}

Payment details

Pay to0xffc458db291b4abce020fe3de4f91f2770e537b1
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase
Schemesexact

Is this your API?

Pin it to the top of Other and the homepage with a featured placement.

Get featured →

More from Up & similar services