{"uid":"cap_v86Tjubt7DFEn6qw5gCFv","slug":"uk-postcode-lookup-api-cc686780","name":"UK Postcode Lookup API","description":"UK postcode lookup, search, validation and autocomplete with x402 payments.","url":"https://postcode.payapi.market/lookup/postcode?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"postcode":{"type":"string","description":"UK postcode to look up; spacing and case are normalised, e.g. 'SW1A 1AA'."}}},"responseSchema":{"type":"json","example":{"found":true,"input":"SW1A 1AA","result":{"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"}}},"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_-Fw3M4bc_ERiKqlohrXp-","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":"Looks up detailed geographic and administrative data for a given UK postcode, including coordinates, ward, district, region, and constituency.","exampleAgentPrompt":"Can you look up the postcode SW1A 1AA and tell me its latitude, longitude, and which parliamentary constituency and London borough it falls in?","exampleUseCases":[{"title":"Delivery address validation for e-commerce","prompt":"I have a customer order shipping to postcode EC1A 1BB — can you check if that's a valid UK postcode and get its region and district so I can route it correctly?"},{"title":"Constituency mapping for political canvassing","prompt":"We're targeting voters in the W1A 1AA postcode — can you tell me which parliamentary constituency that falls under?"},{"title":"Location enrichment for analytics pipeline","prompt":"I have a list of user postcodes starting with M1 1AE — can you resolve that postcode to get its latitude, longitude, LSOA code, and NHS CCG so I can enrich my dataset?"}],"resultDescription":"Returns a JSON object with a 'found' boolean, the normalised input postcode, and a 'result' object containing full geographic and administrative data: latitude, longitude, outcode, incode, region, country, admin ward, admin district, admin county, parish, parliamentary constituency, European electoral region, NHS CCG, primary care trust, LSOA, MSOA, NUTS area, date of introduction, and corresponding ONS/GSS codes for administrative entities.","failureModes":["Postcode not found: returns found=false with no result object","Invalid postcode format: may return an error or found=false if the postcode cannot be normalised","Payment failure: x402 payment not authorised, request rejected before processing","Network timeout: upstream geocoding service unavailable","Terminated postcode: postcode existed historically but has been retired, returns not found"],"whenToPreferThis":"Choose this endpoint when you need comprehensive UK postcode resolution including both geographic coordinates and administrative boundary codes (ward, district, constituency, NHS CCG, LSOA/MSOA) in a single call. It is ideal for address enrichment pipelines, compliance checks requiring ONS codes, delivery routing, or political/health analytics where both location and administrative context are needed. Prefer it over raw geocoding APIs when the input is specifically a UK postcode and you need structured administrative metadata alongside coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:02:56.822Z","isFirstParty":false,"canonicalSlug":"uk-postcode-lookup-api-cc686780"}