Postcodes.io is maintained by Ideal-Postcodes.co.uk


This is a free API. Postcodes.io is aimed at developers who want a resource to lookup and (reverse) geocode UK Postcodes.

Community API Libraries


postcodes_io by Deepak Sunanda Prabhakar


postcodes-io-bundle by the people at Box UK. Read the blog post
(adityamenon) postcodes-io laravel package by Aditya Menon
PHP Class for Postcodes.io by Ryan
(jabranr) postcodes-io by Jabran Rafique


postcodes_io by James Ruston

uk_postcodes_io by Rob Nichols (M&S Venture Labs)


postcodesio-client-node by @billinghamj


PythonPostcodesWrapper by Gokhan Karadas


MarkEmbling.PostcodesIO by Mark Embling


PostcodesioR by Eryk Walczak. Read the blog post


HackPostcodes by Matt Barber

Wolfram Language

postcode by Arnoud Buzing

Google Sheets Addon

UK Postcode Geocoder by Ed Patrick

Noticeboard for 2017

Any updates or disruptions will be listed below.

  • Nothing to date


Leave your email with us to receive critical service information for Postcodes.io


Chat: chat.ideal-postcodes.co.uk

Email: support@ideal-postcodes.co.uk

Twitter: @IdealPostcodes


For bugs and feature requests use our Github issue tracker.


  ONS Postcode Directory OS Open Names
Release Date November 2017 October 2017
Data Points 1,758,312 (+0.12%) 42,214

Beyond the dates listed above, please be aware that the real world dataset may change. Existing postcodes and places may be amended or discontinued. This information will not be captured until the next available update.


Postcodes.io is available under the MIT License

Great Britain postcode data may be used under the terms of the OS OpenData licence.

Northern Ireland postcode data (i.e. beginning "BT") may be used under the terms of the ONSPD licence. Non-commercial use is free. Commercial use requires a license from NI Land & Property Services

Contains Ordnance Survey data © Crown copyright and database right 2017

Contains Royal Mail data © Royal Mail copyright and database right 2017

Contains National Statistics data © Crown copyright and database right 2017

Not to be confused with...

Postcode.io, a laudable company in California providing technology applications and services to local governments.