Postcodes.io

UK postcode locations and nearby postcodes

Postcodes.io provides UK postcode, location and administrative information; nearby postcode results include distance and coordinates, while retired postcodes lack administrative details.

Get postcode

Get the location and administrative details of a UK postcode, including whether it is still in use. Retired postcodes have limited records: administrative details are unavailable and returned as null.

Your information

Postcode

UK postcode, with or without a space and in any letter case, for example SW1A 1AA.

1 credit per run

Example results

Ward

Not provided

County

Not provided

In Use

Parish

Not provided

Region

Not provided

Country

Not provided

Eastings

533,779

Latitude

51.508009

Postcode

E1W 1UU

Longitude

-0.073706

Northings

180,545

Page Link

postcodes.io

Year Retired

2,015

Local Council

Not provided

Parliamentary Constituency

Not provided

Health Board or Integrated Care Board

Not provided

Area Codes

Ward: Not provided
County: Not provided
Parish: Not provided
Local Council: Not provided
Integrated Care Board: Not provided
Parliamentary Constituency: Not provided

Example data · Run in Studio for fresh results.

About Postcodes.io

Postcodes.io returns location, administrative, and in-use details for a UK postcode; enter the postcode.

List nearby postcodes returns nearby postcode locations and distances; enter a UK postcode or place name, with optional distance and result settings.

Built by Fous from postcodes.io and checked automatically; it last passed a check on Sep 29, 2026. Fous is not affiliated with Postcodes.io.

Actions

Get postcode

1 credit per run

What you provide

Field	Type	Required	Description
Postcode`postcode`	Text	Required	UK postcode, with or without a space and in any letter case, for example SW1A 1AA.Example: e1w1uu

What you get

Field	Type	Description
Ward`ward`	Text	Administrative ward.Example: St James's
County`county`	Text	Administrative county, if applicable.
In Use`in_use`	Yes or no	Whether the postcode is currently active.Example: No
Parish`parish`	Text	Civil parish or equivalent, if recorded.Example: Westminster, unparished area
Region`region`	Text	Region, if available.Example: London
Country`country`	Text	UK country.Example: England
Eastings`eastings`	Number	British National Grid easting when provided.Example: 533779
Latitude`latitude`	Number	Latitude in decimal degrees.Example: 51.508009
Postcode`postcode`	Text	Postcode with standard spacing and uppercase letters.Example: E1W 1UU
Longitude`longitude`	Number	Longitude in decimal degrees.Example: -0.073706
Northings`northings`	Number	British National Grid northing when provided.Example: 180545
Page Link`page_link`	Text	Link to the postcode record on Postcodes.io.Example: https://postcodes.io/terminated_postcodes/E1W1UU
Area Codes`area_codes`	Details	Official area identifiers supplied for the postcode; null where unavailable.
Ward`area_codes.ward`	Text	Example: E05013806
County`area_codes.county`	Text
Parish`area_codes.parish`	Text	Example: E43000236
Local Council`area_codes.local_council`	Text	Example: E09000033
Integrated Care Board`area_codes.integrated_care_board`	Text	Example: E54000071
Parliamentary Constituency`area_codes.parliamentary_constituency`	Text	Example: E14001172
Year Retired`year_retired`	Number	Year the postcode was retired, if known.Example: 2015
Local Council`local_council`	Text	Local authority or council area.Example: Westminster
Parliamentary Constituency`parliamentary_constituency`	Text	UK parliamentary constituency.Example: Cities of London and Westminster
Health Board or Integrated Care Board`health_board_or_integrated_care_board`	Text	Integrated care board in England or the available health authority or board elsewhere.Example: NHS West and North London Integrated Care Board

Example result

For Postcode: e1w1uu

JSON

{
  "ward": null,
  "county": null,
  "in_use": false,
  "parish": null,
  "region": null,
  "country": null,
  "eastings": 533779,
  "latitude": 51.508009,
  "postcode": "E1W 1UU",
  "longitude": -0.073706,
  "northings": 180545,
  "page_link": "https://postcodes.io/terminated_postcodes/E1W1UU",
  "area_codes": {
    "ward": null,
    "county": null,
    "parish": null,
    "local_council": null,
    "integrated_care_board": null,
    "parliamentary_constituency": null
  },
  "year_retired": 2015,
  "local_council": null,
  "parliamentary_constituency": null,
  "health_board_or_integrated_care_board": null
}

List nearby postcodes

1 credit per run

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

What you provide

Field	Type	Required	Description
Near`near`	Text	Required	A UK postcode or place name, for example SW1A 1AA or Oxford.Example: SW1A 1AA
Max Results`max_results`	Number	Optional	Maximum number of nearest postcodes, for example 10.Example: 4
Radius (metres)`radius_metres`	Number	Optional	Maximum distance in metres from the postcode or place, for example 1000.Example: 1000

What you get

Field	Type	Description
Postcodes`postcodes`	List	Postcodes ordered nearest first.
Ward`postcodes[].ward`	Text	Example: St James's
Latitude`postcodes[].latitude`	Number	Example: 51.50101
Page URL`postcodes[].page_url`	Text	Example: https://postcodes.io/postcodes/SW1A%201AA
Postcode`postcodes[].postcode`	Text	Example: SW1A 1AA
Longitude`postcodes[].longitude`	Number	Example: -0.141563
Local Council`postcodes[].local_council`	Text	Example: Westminster
Distance (metres)`postcodes[].distance_metres`	Number	Example: 0

Example result

For Near: SW1A 1AA

JSON

{
  "postcodes": [
    {
      "ward": "St James's",
      "latitude": 51.50101,
      "page_url": "https://postcodes.io/postcodes/SW1A%201AA",
      "postcode": "SW1A 1AA",
      "longitude": -0.141563,
      "local_council": "Westminster",
      "distance_metres": 0
    },
    {
      "ward": "St James's",
      "latitude": 51.499933,
      "page_url": "https://postcodes.io/postcodes/SW1E%206LA",
      "postcode": "SW1E 6LA",
      "longitude": -0.141117,
      "local_council": "Westminster",
      "distance_metres": 123.67233656624896
    },
    {
      "ward": "St James's",
      "latitude": 51.499738,
      "page_url": "https://postcodes.io/postcodes/SW1E%206AY",
      "postcode": "SW1E 6AY",
      "longitude": -0.140736,
      "local_council": "Westminster",
      "distance_metres": 152.5853742672548
    }
  ]
}

For developers

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL

# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@postcodes-io",
  "visibility": "public",
  "operation": "get_postcode",
  "version": 1,
  "input": {
    "postcode": "e1w1uu"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Find a postcode’s coordinates and administrative areas
Check whether a postcode is still in use
Find postcodes near a place or postcode
Compare distances between nearby postcodes

Questions

Is Fous affiliated with Postcodes.io?

No. Fous is not affiliated with Postcodes.io. This workflow reads the public postcodes.io website and returns its data.

How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

Do I need a Postcodes.io account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from postcodes.io when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.