/postcodes.io

UK Postcode API serving up Open Data

Primary LanguageJavaScriptMIT LicenseMIT

Postcodes.io

UK postcode & geolocation API, serving up open data

CircleCI Coverage Status Dependency Status

Query for UK postcodes and geolocations over HTTP.

Postcodes.io regularly ingests and serves the ONS Postcode Directory and Ordnance Survey Open Names datasets.

Features

  • Postcode lookup, resolve administrative and location data for postcodes and outward codes
  • Postcode search & autocomplete
  • Reverse geocode postcodes
  • Nearest postcode search
  • Terminated postcode search
  • Outward code lookup
  • Bulk postcode lookup and reverse geocoding

Usage

Quick Start

Start querying UK postcode data immediately on your local machine with Docker

docker-compose up

Docker Compose Demo

Testing

# Run a postgres container listening on port 5432
docker-compose -f docker-compose-test.yml up 

npm test

License

MIT