Skip to main content
All providers

postcodes.io

GeocodingGB

api.postcodes.io

UK postcode lookup and geocoding: administrative, electoral and health geographies, latitude/longitude, and reverse geocoding from a point, built on Ordnance Survey and Royal Mail data.

Capabilities (4)

GET /v1/data/postcodes-io/bulk-postcodes1 credit

Up to 100 postcode records in one response, keyed by the query order.

q
GET /v1/data/postcodes-io/outcode1 credit

The geographic centroid and bounding box of a postcode district (outcode), such as SW1A.

outcode
GET /v1/data/postcodes-io/postcode1 credit

Full record for one UK postcode: coordinates, local authority, ward, constituency, region, country, LSOA/MSOA and quality indicators.

postcode
GET /v1/data/postcodes-io/reverse-geocode1 credit

The nearest postcodes to a latitude/longitude with their distance in metres, plus the administrative areas covering the point.

lonlatlimit?radius?

Licence

The postcodes.io site states "Open Source MIT licensed" and its source repository is MIT. That MIT grant covers the SOFTWARE (the API server), not the postcode dataset, which the site attributes to "Ordnance Survey and other UK data providers" without restating their terms. No explicit data-reuse licence is reproduced on the site, so no reuse right is claimed here beyond reading the API.

https://postcodes.io/

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: postcodes.io. Postcode data from Ordnance Survey and Royal Mail via postcodes.io.

Cache: up to 3600s