# Postcodes.io API

> 2 public methods for Postcodes.io (postcodes.io), each 1 credit per completed run.

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

- Page: https://fous.com/methods/postcodes.io

## Methods

### [Get postcode details](https://fous.com/methods/postcodes.io/get-postcode.md)

`postcodes.io/get_postcode`, read. 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

### [List nearby postcodes](https://fous.com/methods/postcodes.io/list-nearby-postcodes.md)

`postcodes.io/list_nearby_postcodes`, read. 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