{"uid":"cap_tVwlq7XcunWI4TQkvdArl","slug":"uk-postcode-lookup-f9828471","name":"UK Postcode Lookup","description":"UK postcode lookup (ONS Postcode Directory via postcodes.io): lat/lon, country, region, local authority, ward, parliamentary constituency, NHS ICB, police force, LSOA. Unknown postcode = not charged.","url":"https://gogeta2-u35175.vm.elestio.app/agents/v1/geo/uk-postcode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["postcode"],"properties":{"postcode":{"type":"string","description":"UK postcode, e.g. SW1A 2AA"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CRhWxLxd64w8lggdUf_zr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns geographic and administrative metadata for a UK postcode including lat/lon, country, region, local authority, ward, parliamentary constituency, NHS ICB, and police force.","exampleAgentPrompt":"Can you look up the postcode SW1A 2AA and tell me its latitude, longitude, local authority, parliamentary constituency, and which police force covers it?","exampleUseCases":[{"title":"Enrich address records with admin boundaries","prompt":"I have a list of customer postcodes and I need to know which local authority and region each one falls in — can you look up EC2A 4PQ and give me those details?"},{"title":"Route delivery by NHS ICB or police force area","prompt":"We're assigning field agents by health region — can you look up the postcode BS1 4DJ and tell me which NHS ICB and county it belongs to?"},{"title":"Validate constituency for voter registration","prompt":"Can you check the postcode LS1 1BA and confirm which parliamentary constituency it sits in, along with the ward name?"}],"resultDescription":"Returns structured geographic and administrative data for the given UK postcode including: latitude and longitude, country, region, local authority district, ward, parliamentary constituency, NHS Integrated Care Board (ICB), police force area, and LSOA code. If the postcode is unknown or invalid, the request is not charged.","failureModes":["Unknown or invalid postcode returns a not-found response and is not charged","Malformed postcode string (e.g. missing space, incorrect format) may return an error","Postcode may be valid but not yet in the ONS directory if very recently assigned"],"whenToPreferThis":"Use this endpoint when you need accurate, ONS-sourced administrative boundary data for UK postcodes, including NHS ICB, police force, and LSOA — metadata that generic geocoding APIs do not provide. Prefer it over raw geocoding services when UK-specific administrative enrichment is the goal, and over manual lookup when automating at scale.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:32:22.327Z","isFirstParty":false,"canonicalSlug":"uk-postcode-lookup-f9828471"}