About

Postcodes.io is an open sourced project maintained by Ideal Postcodes.
It is a free resource, allowing developers to search, reverse geocode and extract UK postcode and associated data.

Community API Libraries

Java

postcodes_io by Deepak Sunanda Prabhakar

PHP

LaravelPostcodes by Steve McDougall.
Postcodes.io API module for Drupal by Dakku Singh.
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
PHP Software Development Kit by Ammaar Latif

Ruby

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

Node.js

postcodesio-client-node by @billinghamj
Node JS Client/Wrapper by Lawrence Cherone

Python

PythonPostcodesWrapper by Gokhan Karadas
postcodes_io_api by Rohit Deshmukh (Python Package)

MarkEmbling.PostcodesIO by Mark Embling

PostcodesioR by rOpenSci. Read the blog post

Rust

postcode-rs by Grant Handy.

Hack

HackPostcodes by Matt Barber

Perl

Perl example provided by digdilem

Helm Chart

postcodes-io-helm-chart by Nic West

Wolfram Language

postcode by Arnoud Buzing

Google Sheets Addon

UK Postcode Geocoder by Ed Patrick

Javascript / Typescript Library

postcodes.io by Steve Goossens

Support

Chat: chat.ideal-postcodes.co.uk

Email: [email protected]

Twitter: @IdealPostcodes

GitHub

For bugs and feature requests use our GitHub issue tracker.

Data

	ONS Postcode Directory	OS Open Names	Scottish Postcode Directory
Release Date	August 2024	July 2024	January 2024

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