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 completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

E1W 1UU

Currently in useNo

Year retired2,015

Administrative details

Location

Latitude: 51.51
Longitude: -0.07371
Easting: 533,779
Northing: 180,545

View postcode record

About the Postcodes.io tool

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 from postcodes.io. Last checked Sep 29, 2026.

Actions

Get postcode

1 credit

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

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

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_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 about Postcodes.io

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this Postcodes.io tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. 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. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.