{"uid":"cap_3ggOah-ttftWm3EqjW-AR","slug":"uk-postcode-nearest-lookup-44bf14c2","name":"UK Postcode Nearest Lookup","description":"Find UK postcodes within a radius (100-2000m) of a lat/lng, each with its distance in metres from the query point.","url":"https://postcode-api-production.up.railway.app/lookup/nearest","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude in decimal degrees, e.g. 51.5014."},"lng":{"type":"number","description":"Longitude in decimal degrees, e.g. -0.1419."},"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of postcodes to return (1-100, default 10)."},"radius":{"type":"integer","maximum":2000,"minimum":100,"description":"Search radius in metres (100-2000, default 1000)."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OplyYQG454DJKoITcedV8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns UK postcodes within a specified radius (100–2000m) of a latitude/longitude point, each with its distance in metres.","exampleAgentPrompt":"Can you find all UK postcodes within 500 metres of latitude 51.5014, longitude -0.1419, and give me up to 20 results sorted by how close they are?","exampleUseCases":[{"title":"Delivery zone postcode finder","prompt":"I need to find all UK postcodes within 800 metres of our warehouse at latitude 53.4808, longitude -2.2426 — give me up to 50 results so I can build our local delivery zone list."},{"title":"Nearest postcode for a GPS pin","prompt":"Someone dropped a GPS pin at 51.5074, -0.1278 and I need to know which UK postcodes are within 200 metres of that point — return up to 10, closest first."},{"title":"Store catchment area mapping","prompt":"For our new shop at coordinates 55.8642, -4.2518 in Glasgow, can you list all postcodes within 1500 metres so we can map our catchment area? Limit to 100 results."}],"resultDescription":"A list of UK postcode records each containing the postcode string and its distance in metres from the query lat/lng, ordered by proximity, up to the requested limit.","failureModes":["Radius out of range (must be 100–2000m) returns validation error","Limit out of range (must be 1–100) returns validation error","Invalid or missing lat/lng returns a bad request error","No postcodes found within the specified radius returns an empty list","Coordinates outside the UK may return empty results or unexpected data","Payment failure or insufficient balance returns 402 error"],"whenToPreferThis":"Use this endpoint when you need to discover all UK postcodes within a specific geographic radius of known coordinates, especially when distance from the query point matters (e.g. building delivery zones, catchment areas, or proximity-ranked lists). Prefer this over a text search or single postcode lookup when you have lat/lng rather than a postcode or address, and you need multiple nearby results with distances.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:32.021Z","isFirstParty":false}