{"openapi":"3.1.0","info":{"title":"UK Open Data","version":"1.0.0","description":"UK postcodes, police crime data and bank holidays from free government sources. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"UK Open Data: UK postcodes, police crime data and bank holidays from free government sources. /postcode-lookup, /postcode-nearest, /postcode-validate, /crime-near (counts by category for a point and month), /bank-holidays, /next-bank-holiday, /police-force-for-point. Each paid GET returns a computed verdict with the reasons, the source and what was NOT checked. A verdict of UNVERIFIED means a lookup failed: treat it as unknown. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://uk-open-data.x402tookit.com"}],"paths":{"/bank-holidays":{"get":{"operationId":"bank_holidays","summary":"Official UK bank holidays for England and Wales, Scotland or Northern Ireland in a given year, with weekdays, from GOV.UK.","description":"Official UK bank holidays for England and Wales, Scotland or Northern Ireland in a given year, with weekdays, from GOV.UK.","tags":["uk","bank-holidays","calendar","gov-uk"],"parameters":[{"name":"division","in":"query","required":false,"description":"england-and-wales (default), scotland or northern-ireland","schema":{"type":"string","enum":["england-and-wales","scotland","northern-ireland"]}},{"name":"year","in":"query","required":false,"description":"Calendar year, default the current year","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"division":{"type":["null","string"]},"divisionName":{"type":["null","string"]},"year":{"type":["null","number"]},"count":{"type":["null","number"]},"coveredFrom":{"type":["null","string"]},"coveredTo":{"type":["null","string"]},"holidays":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":["null","string"]},"date":{"type":["null","string"]},"weekday":{"type":["null","string"]},"notes":{"type":["null","string"]},"bunting":{"type":["boolean","null"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"HOLIDAYS_LISTED","summary":"Scotland has 10 bank holidays in 2026, from New Year’s Day (2026-01-01) to Boxing Day (2026-12-28).","reasons":["Dates are as published by GOV.UK, already moved to the weekday where the actual day falls on a weekend (a 'substitute day')."],"division":"scotland","divisionName":"Scotland","year":2026,"count":10,"coveredFrom":"2019-01-01","coveredTo":"2028-12-26","holidays":[{"title":"New Year’s Day","date":"2026-01-01","weekday":"Thursday","notes":null,"bunting":true},{"title":"2nd January","date":"2026-01-02","weekday":"Friday","notes":null,"bunting":true}],"degraded":false,"notChecked":["one-off extra bank holidays announced after the feed was last updated","regional or local holidays (for example local Scottish council holidays) and religious observances"],"source":"GOV.UK bank holidays (Open Government Licence v3.0)","sourceUrl":"https://www.gov.uk/bank-holidays","asOf":"2026-10-21T00:43:53.187Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/bank-holidays"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/bank-holidays"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/bank-holidays"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/bank-holidays"}}]}}},"/crime-near":{"get":{"operationId":"crime_near","summary":"Police street-crime counts by category within 1 mile of a UK point for a month (Eng, Wales, NI); data lags ~2 months.","description":"Police street-crime counts by category within 1 mile of a UK point for a month (Eng, Wales, NI); data lags ~2 months.","tags":["uk","crime","police","data-police-uk","neighbourhood"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude of the point (England, Wales or Northern Ireland)","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude of the point","schema":{"type":"number"}},{"name":"month","in":"query","required":false,"description":"YYYY-MM; default is the latest month the police have published (about 2 months old)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"month":{"type":["null","string"]},"latestPublishedMonth":{"type":["null","string"]},"radiusRule":{"type":["null","string"]},"force":{"type":["null","string"]},"neighbourhood":{"type":["null","string"]},"totalCrimes":{"type":["null","number"]},"byCategory":{"type":["array","null"],"items":{"type":"object","properties":{"category":{"type":["null","string"]},"count":{"type":["null","number"]},"label":{"type":["null","string"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"CRIMES_RECORDED","summary":"3679 police-recorded crimes within about 1 mile of 51.5007, -0.1246 in 2026-07; most common: Other theft (759).","reasons":["data.police.uk returns crimes within roughly a 1 mile radius of the point.","Data is published about 2 months behind; 2026-07 is 3 months old and the newest published month is 2026-08.","…1 more"],"month":"2026-07","latestPublishedMonth":"2026-08","radiusRule":"about 1 mile around the point (set by data.police.uk)","force":"metropolitan","neighbourhood":"E05013806N","totalCrimes":3679,"byCategory":[{"category":"other-theft","count":759,"label":"Other theft"},{"category":"violent-crime","count":679,"label":"Violence and sexual offences"}],"degraded":false,"notChecked":["crimes not reported to or recorded by the police","exact crime locations (the police move each crime to a nearby anonymised street point)","…2 more"],"source":"data.police.uk (Open Government Licence v3.0)","sourceUrl":"https://data.police.uk","asOf":"2026-10-21T00:43:55.911Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0300"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/crime-near"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/crime-near"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/crime-near"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/crime-near"}}]}}},"/next-bank-holiday":{"get":{"operationId":"next_bank_holiday","summary":"Next UK bank holiday on or after a date (default today) for England and Wales, Scotland or Northern Ireland, plus the next two.","description":"Next UK bank holiday on or after a date (default today) for England and Wales, Scotland or Northern Ireland, plus the next two.","tags":["uk","bank-holidays","calendar","gov-uk"],"parameters":[{"name":"division","in":"query","required":false,"description":"england-and-wales (default), scotland or northern-ireland","schema":{"type":"string","enum":["england-and-wales","scotland","northern-ireland"]}},{"name":"from","in":"query","required":false,"description":"YYYY-MM-DD to count from, default today (UTC)","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"division":{"type":["null","string"]},"from":{"type":["null","string"]},"fromWeekday":{"type":["null","string"]},"next":{"type":["null","object"],"properties":{"title":{"type":["null","string"]},"date":{"type":["null","string"]},"weekday":{"type":["null","string"]},"daysAway":{"type":["null","number"]},"notes":{}}},"followingTwo":{"type":["array","null"],"items":{"type":"object","properties":{"title":{"type":["null","string"]},"date":{"type":["null","string"]},"weekday":{"type":["null","string"]},"daysAway":{"type":["null","number"]},"notes":{"type":["null","string"]}}}},"feedEnds":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NEXT_FOUND","summary":"Next England and Wales bank holiday after 2026-10-20: Christmas Day on Friday 2026-12-25, in 66 days.","reasons":["The list includes the starting date itself if it is a bank holiday (daysAway 0)."],"division":"england-and-wales","from":"2026-10-20","fromWeekday":"Tuesday","next":{"title":"Christmas Day","date":"2026-12-25","weekday":"Friday","daysAway":66,"notes":null},"followingTwo":[{"title":"Boxing Day","date":"2026-12-28","weekday":"Monday","daysAway":69,"notes":"Substitute day"},{"title":"New Year’s Day","date":"2027-01-01","weekday":"Friday","daysAway":73,"notes":null}],"feedEnds":"2028-12-26","degraded":false,"notChecked":["one-off extra bank holidays announced after the feed was last updated","regional and local holidays"],"source":"GOV.UK bank holidays (Open Government Licence v3.0)","sourceUrl":"https://www.gov.uk/bank-holidays","asOf":"2026-10-21T00:43:57.742Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/next-bank-holiday"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/next-bank-holiday"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/next-bank-holiday"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/next-bank-holiday"}}]}}},"/outcode-lookup":{"get":{"operationId":"outcode_lookup","summary":"Look up a UK outcode (e.g. EC1A, SW1A, M1): centre coordinates, districts, wards, parishes and constituencies it covers.","description":"Look up a UK outcode (e.g. EC1A, SW1A, M1): centre coordinates, districts, wards, parishes and constituencies it covers.","tags":["uk","outcode","postcode-district","postcodes-io"],"parameters":[{"name":"outcode","in":"query","required":true,"description":"Outward code, e.g. EC1A, W1A, M1, B33, CR2, DN55","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"outcode":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"districts":{"type":["array","null"],"items":{"type":"string"}},"counties":{"type":["array","null"]},"wards":{"type":["array","null"],"items":{"type":"string"}},"parishes":{"type":["array","null"],"items":{"type":"string"}},"countries":{"type":["array","null"],"items":{"type":"string"}},"constituencies":{"type":["array","null"],"items":{"type":"string"}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"EC1A is centred at 51.5205, -0.1042 and touches City of London, Islington.","reasons":[],"outcode":"EC1A","lat":51.52053306060618,"lon":-0.10417533333333336,"districts":["City of London","Islington"],"counties":[],"wards":["Aldersgate","Bunhill","…4 more"],"parishes":["City of London, unparished area","Islington, unparished area"],"countries":["England"],"constituencies":["Cities of London and Westminster","Islington South and Finsbury"],"degraded":false,"notChecked":["the boundary of the outcode area (only a centre point and the names of areas it touches are given)"],"source":"postcodes.io (ONS / Ordnance Survey open data)","sourceUrl":"https://postcodes.io","asOf":"2026-10-21T00:43:59.597Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/outcode-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/outcode-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/outcode-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/outcode-lookup"}}]}}},"/police-force-for-point":{"get":{"operationId":"police_force_for_point","summary":"Which UK police force and neighbourhood team covers a lat/lon (England, Wales, NI), with the force website and 101 number.","description":"Which UK police force and neighbourhood team covers a lat/lon (England, Wales, NI), with the force website and 101 number.","tags":["uk","police","neighbourhood","data-police-uk"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude, -90 to 90","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude, -180 to 180","schema":{"type":"number"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"forceId":{"type":["null","string"]},"forceName":{"type":["null","string"]},"neighbourhoodId":{"type":["null","string"]},"website":{"type":["null","string"]},"nonEmergencyPhone":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FORCE_FOUND","summary":"Metropolitan Police Service covers 51.5007, -0.1246 (neighbourhood E05013806N).","reasons":["Call 101 for non-emergencies and 999 in an emergency."],"forceId":"metropolitan","forceName":"Metropolitan Police Service","neighbourhoodId":"E05013806N","website":"https://www.met.police.uk/","nonEmergencyPhone":"101","degraded":false,"notChecked":["British Transport Police, which covers railways everywhere and is not tied to a place","Police Scotland (not in data.police.uk)","…1 more"],"source":"data.police.uk (Open Government Licence v3.0)","sourceUrl":"https://data.police.uk","asOf":"2026-10-21T00:44:02.151Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/police-force-for-point"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/police-force-for-point"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/police-force-for-point"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/police-force-for-point"}}]}}},"/postcode-lookup":{"get":{"operationId":"postcode_lookup","summary":"Look up a UK postcode: coordinates, council, ward, constituency, region and police force area; flags terminated postcodes.","description":"Look up a UK postcode: coordinates, council, ward, constituency, region and police force area; flags terminated postcodes.","tags":["uk","postcode","geocoding","postcodes-io"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"UK postcode with or without the space, e.g. EC1A 1BB","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"postcodeInfo":{"type":["null","object"],"properties":{"postcode":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"country":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"county":{},"ward":{"type":["null","string"]},"parish":{"type":["null","string"]},"constituency":{"type":["null","string"]},"policeForceArea":{"type":["null","string"]},"lsoa":{"type":["null","string"]},"quality":{"type":["null","number"]},"eastings":{"type":["null","number"]},"northings":{"type":["null","number"]},"introduced":{"type":["null","string"]},"terminated":{},"outcode":{"type":["null","string"]},"incode":{"type":["null","string"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"FOUND","summary":"EC1A 1BB is in Islington, London (51.524567, -0.112017).","reasons":[],"postcodeInfo":{"postcode":"EC1A 1BB","lat":51.524567,"lon":-0.112017,"country":"England","region":"London","district":"Islington","county":null,"ward":"Clerkenwell","parish":"Islington, unparished area","constituency":"Islington South and Finsbury","policeForceArea":"Metropolitan Police","lsoa":"Islington 022F","quality":1,"eastings":531073,"northings":182317,"introduced":"198410","terminated":null,"outcode":"EC1A","incode":"1BB"},"degraded":false,"notChecked":["whether anyone lives or receives post at this postcode (this is geography, not Royal Mail delivery data)","the coordinates are for the postcode's centre, not a building"],"source":"postcodes.io (ONS / Ordnance Survey open data)","sourceUrl":"https://postcodes.io","asOf":"2026-10-21T00:44:03.977Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-lookup"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-lookup"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-lookup"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-lookup"}}]}}},"/postcode-nearest":{"get":{"operationId":"postcode_nearest","summary":"Nearest UK postcodes to a given postcode, with distance in metres, council and ward, via postcodes.io.","description":"Nearest UK postcodes to a given postcode, with distance in metres, council and ward, via postcodes.io.","tags":["uk","postcode","nearby","postcodes-io"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"UK postcode, e.g. SW1A 2JR","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results, 1 to 20, default 5","schema":{"type":"integer"}},{"name":"radius_m","in":"query","required":false,"description":"Search radius in metres, 50 to 2000, default 500","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"radiusM":{"type":["null","number"]},"nearby":{"type":["array","null"],"items":{"type":"object","properties":{"postcode":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"country":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"county":{},"ward":{"type":["null","string"]},"parish":{"type":["null","string"]},"constituency":{"type":["null","string"]},"policeForceArea":{"type":["null","string"]},"lsoa":{"type":["null","string"]},"quality":{"type":["null","number"]},"eastings":{"type":["null","number"]},"northings":{"type":["null","number"]},"introduced":{"type":["null","string"]},"terminated":{},"outcode":{"type":["null","string"]},"incode":{"type":["null","string"]},"distanceM":{"type":["null","number"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NEARBY_FOUND","summary":"5 postcodes within 300 m of SW1A 2JR; closest SW1A 2JR at 0 m.","reasons":["The starting postcode itself may appear in the list at distance 0."],"radiusM":300,"nearby":[{"postcode":"SW1A 2JR","lat":51.501172,"lon":-0.125174,"country":"England","region":"London","district":"Westminster","county":null,"ward":"St James's","parish":"Westminster, unparished area","constituency":"Cities of London and Westminster","policeForceArea":"Metropolitan Police","lsoa":"Westminster 020C","quality":1,"eastings":530227,"northings":179692,"introduced":"198001","terminated":null,"outcode":"SW1A","incode":"2JR","distanceM":0},{"postcode":"SW1A 2JX","lat":51.501208,"lon":-0.125763,"country":"England","region":"London","district":"Westminster","county":null,"ward":"St James's","parish":"Westminster, unparished area","constituency":"Cities of London and Westminster","policeForceArea":"Metropolitan Police","lsoa":"Westminster 020C","quality":1,"eastings":530186,"northings":179695,"introduced":"199007","terminated":null,"outcode":"SW1A","incode":"2JX","distanceM":41}],"degraded":false,"notChecked":["walking distance (distance is straight-line between postcode centres)","whether neighbouring postcodes are residential or commercial"],"source":"postcodes.io (ONS / Ordnance Survey open data)","sourceUrl":"https://postcodes.io","asOf":"2026-10-21T00:44:05.791Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-nearest"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-nearest"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-nearest"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-nearest"}}]}}},"/postcode-reverse":{"get":{"operationId":"postcode_reverse","summary":"Reverse geocode a lat/lon to the nearest UK postcodes with distance, council, ward and constituency via postcodes.io.","description":"Reverse geocode a lat/lon to the nearest UK postcodes with distance, council, ward and constituency via postcodes.io.","tags":["uk","postcode","reverse-geocoding","postcodes-io"],"parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude, -90 to 90","schema":{"type":"number"}},{"name":"lon","in":"query","required":true,"description":"Longitude, -180 to 180","schema":{"type":"number"}},{"name":"limit","in":"query","required":false,"description":"Results, 1 to 10, default 3","schema":{"type":"integer"}},{"name":"radius_m","in":"query","required":false,"description":"Search radius in metres, 50 to 2000, default 200","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"radiusM":{"type":["null","number"]},"postcodes":{"type":["array","null"],"items":{"type":"object","properties":{"postcode":{"type":["null","string"]},"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"country":{"type":["null","string"]},"region":{"type":["null","string"]},"district":{"type":["null","string"]},"county":{},"ward":{"type":["null","string"]},"parish":{"type":["null","string"]},"constituency":{"type":["null","string"]},"policeForceArea":{"type":["null","string"]},"lsoa":{"type":["null","string"]},"quality":{"type":["null","number"]},"eastings":{"type":["null","number"]},"northings":{"type":["null","number"]},"introduced":{"type":["null","string"]},"terminated":{},"outcode":{"type":["null","string"]},"incode":{"type":["null","string"]},"distanceM":{"type":["null","number"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"POSTCODES_FOUND","summary":"Closest postcode to 51.5007, -0.1246 is SW1A 2JR (66 m, Westminster).","reasons":["Distance is to the postcode's centre point."],"radiusM":200,"postcodes":[{"postcode":"SW1A 2JR","lat":51.501172,"lon":-0.125174,"country":"England","region":"London","district":"Westminster","county":null,"ward":"St James's","parish":"Westminster, unparished area","constituency":"Cities of London and Westminster","policeForceArea":"Metropolitan Police","lsoa":"Westminster 020C","quality":1,"eastings":530227,"northings":179692,"introduced":"198001","terminated":null,"outcode":"SW1A","incode":"2JR","distanceM":66},{"postcode":"SW1A 2LW","lat":51.501348,"lon":-0.124345,"country":"England","region":"London","district":"Westminster","county":null,"ward":"St James's","parish":"Westminster, unparished area","constituency":"Cities of London and Westminster","policeForceArea":"Metropolitan Police","lsoa":"Westminster 020C","quality":1,"eastings":530284,"northings":179713,"introduced":"199812","terminated":null,"outcode":"SW1A","incode":"2LW","distanceM":74}],"degraded":false,"notChecked":["points outside the UK (postcodes.io covers UK postcodes only)","which building or property the point is in"],"source":"postcodes.io (ONS / Ordnance Survey open data)","sourceUrl":"https://postcodes.io","asOf":"2026-10-21T00:44:07.601Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-reverse"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-reverse"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-reverse"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-reverse"}}]}}},"/postcode-validate":{"get":{"operationId":"postcode_validate","summary":"Validate a UK postcode: format rules (outward/inward split) plus live existence and terminated status via postcodes.io.","description":"Validate a UK postcode: format rules (outward/inward split) plus live existence and terminated status via postcodes.io.","tags":["uk","postcode","validation","postcodes-io"],"parameters":[{"name":"postcode","in":"query","required":true,"description":"UK postcode to check, e.g. EC1A 1BB or ec1a1bb","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"]},"input":{"type":["null","string"]},"formatValid":{"type":["boolean","null"]},"outcode":{"type":["null","string"]},"incode":{"type":["null","string"]},"formatted":{"type":["null","string"]},"shape":{"type":["null","string"]},"exists":{"type":["boolean","null"]},"terminated":{"type":["boolean","null"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VALID_EXISTS","summary":"EC1A 1BB is well-formed and exists in the current postcode directory.","reasons":[],"input":"EC1A 1BB","formatValid":true,"outcode":"EC1A","incode":"1BB","formatted":"EC1A 1BB","shape":"AA9A 9AA","exists":true,"terminated":false,"degraded":false,"notChecked":["whether the postcode is deliverable or in use today by a building (existence here means it is in the ONS directory)"],"source":"postcodes.io (ONS / Ordnance Survey open data)","sourceUrl":"https://postcodes.io","asOf":"2026-10-21T00:44:09.403Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-validate"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-validate"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-validate"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://uk-open-data.x402tookit.com/postcode-validate"}}]}}}}}