About


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

Java

postcodes_io by Deepak Sunanda Prabhakar

PHP

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

Ruby

postcodes_io by James Ruston uk_postcodes_io by Rob Nichols (M&S Venture Labs)

Node.js

postcodesio-client-node by @billinghamj

Python

PythonPostcodesWrapper by Gokhan Karadas

C#

MarkEmbling.PostcodesIO by Mark Embling

R

PostcodesioR by Eryk Walczak. Read the blog post

Hack

HackPostcodes by Matt Barber

Wolfram Language

postcode by Arnoud Buzing

Google Sheets Addon

UK Postcode Geocoder by Ed Patrick


Noticeboard for 2018

Any updates or disruptions will be listed below.

  • 14-18 June Following the switch to the new ONSPD CSV schema, longitude and latitude for entities with no geolocation were returned as 0 and 99.9999... instead of null and null. Old behaviour has been restored as at 19th June (version 9.0.1)
  • 29 August A data centre network failure caused 6 minutes of outage (between 17:25 UTC and 17:31 UTC). After the API was restored, there was elevated response latency for ~30 minutes as more resources were brought online to compensate for lost capacity
  • 30 August Between Aug 29 17:31 UTC and Aug 30 14:39 UTC, the API returned incorrect longitude values on the terminated_postcodes/ endpoint. Longitude was incorrectly reported as null for a subset (321,831 of 851,354) of terminated postcodes

Email

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


Support

Chat: chat.ideal-postcodes.co.uk

Email: support@ideal-postcodes.co.uk

Twitter: @IdealPostcodes


GitHub

For bugs and feature requests use our GitHub issue tracker.


Data

  ONS Postcode Directory OS Open Names
Release Date November 2018 October 2018
Data Points 1,766,803 (+0.07%) 42,204 (+0)

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.


Licence

Postcodes.io is available under the MIT Licence

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 licence from NI Land & Property Services

Contains Ordnance Survey data © Crown copyright and database right 2018

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

Contains National Statistics data © Crown copyright and database right 2018