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


postcodesio-client-node by @billinghamj


PythonPostcodesWrapper by Gokhan Karadas


MarkEmbling.PostcodesIO by Mark Embling


PostcodesioR by Eryk Walczak. Read the blog post

Google Sheets Addon

UK Postcode Geocoder by Ed Patrick

Noticeboard for 2016

Any updates or disruptions will be listed below.

  • 17 Jan. 2-3 minutes of downtime around 1pm GMT to upgrade server


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.


This API is up-to-date with the ONS's Postcode Directory for November 2016. Beyond that date, new postcodes may be added. Existing postcodes may be amended or discontinued. This information will not be captured until the next quarterly 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 2016

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

Contains National Statistics data © Crown copyright and database right 2016

Not to be confused with...

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