Skip to content

Postcodes.io API

Postcodes.io (postcodes.io) has 2 public methods: get postcode details and list nearby postcodes. Each costs 1 credit per completed run (1¢ with pay as you go); failed runs are free.

postcodes.io (opens in a new tab)

Unofficial. Not affiliated with or endorsed by Postcodes.io.

Methods

2

  • Get postcode details

    Looks up a UK postcode on Postcodes.io, including its location, administrative areas and whether it is still in use. Retired postcodes return location and retirement year only.

    Returns postcode, country, region, council, ward, parish, constituency, health board, coordinates, in_use, year_retired, area codes

    Readpostcodes.io/get_postcode

  • List nearby postcodes

    Lists UK postcodes nearest to a postcode or named place, with distance, ward, council and coordinates. For places sharing a name, a city or town is preferred.

    Returns postcode, distance, ward, council, latitude, longitude, page URL

    Readpostcodes.io/list_nearby_postcodes