Api Endpoint

postcode-api-production.up.railway.app

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

Open interactive test console

Offering

Provider
postcode-api-production.up.railway.app
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Location And Travel
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://postcode-api-production.up.railway.app/lookup/nearest
MIME type
Not provided
First seen
2026-10-16T01:58:03.323Z
Last seen
Tags
None supplied

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.001 USDC
Atomic price: 1000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1000",
    "payTo": "0xFFc458dB291b4ABcE020fE3de4f91F2770E537b1"
  }
]

Observed health

Status
Reachable
Latest latency
105 ms
Average latency
168 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "lat": {
          "description": "Latitude in decimal degrees, e.g. 51.5014.",
          "type": "number"
        },
        "limit": {
          "description": "Maximum number of postcodes to return (1-100, default 10).",
          "maximum": 100,
          "minimum": 1,
          "type": "integer"
        },
        "lng": {
          "description": "Longitude in decimal degrees, e.g. -0.1419.",
          "type": "number"
        },
        "radius": {
          "description": "Search radius in metres (100-2000, default 1000).",
          "maximum": 2000,
          "minimum": 100,
          "type": "integer"
        }
      },
      "required": [
        "lat",
        "lng"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "count": {
          "type": "integer"
        },
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        },
        "radius_m": {
          "type": "integer"
        },
        "results": {
          "description": "Nearby postcode records, each with an added distance_m field (metres from the query point).",
          "items": {
            "properties": {
              "admin_county": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "admin_district": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "admin_ward": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ccg": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "codes": {
                "type": "object"
              },
              "country": {
                "type": "string"
              },
              "date_of_introduction": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_m": {
                "type": "number"
              },
              "european_electoral_region": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "incode": {
                "type": "string"
              },
              "latitude": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "longitude": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "lsoa": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "msoa": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "nuts": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "outcode": {
                "type": "string"
              },
              "parish": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "parliamentary_constituency": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "postcode": {
                "type": "string"
              },
              "primary_care_trust": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "quality": {
                "type": "integer"
              },
              "region": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "type": "object"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}