Find Nearest Postcode

Returns a list of postcodes nearest to the specified postcode, ordered by distance.

All standard postcode fields are returned for each result, plus a distance attribute (in metres from the specified postcode); if the input postcode is not found, the API returns a 404 response code.

For more details, see the API documentation.

Endpoint

GET https://api.postcodes.io/postcodes/:postcode/nearest

Example Request

https://api.postcodes.io/postcodes/NW19HZ/nearest

Example Response

{
  "status": 200,
  "result": [
    {
      "postcode": "NW1 9HZ",
      "quality": 1,
      "eastings": 529254,
      "northings": 184547,
      "country": "England",
      "nhs_ha": "London",
      "longitude": -0.137429,
      "latitude": 51.545024,
      "european_electoral_region": "London",
      "primary_care_trust": "Camden",
      "region": "London",
      "lsoa": "Camden 009A",
      "msoa": "Camden 009",
      "incode": "9HZ",
      "outcode": "NW1",
      "parliamentary_constituency": "Holborn and St Pancras",
      "parliamentary_constituency_2024": "Holborn and St Pancras",
      "admin_district": "Camden",
      "parish": "Camden, unparished area",
      "admin_county": null,
      "date_of_introduction": "199912",
      "admin_ward": "Kentish Town South",
      "ced": null,
      "ccg": "NHS North Central London",
      "nuts": "Camden",
      "pfa": "Metropolitan Police",
      "nhs_region": "London",
      "ttwa": "London",
      "national_park": null,
      "bua": "Greater London",
      "icb": "NHS North Central London Integrated Care Board",
      "cancer_alliance": "North Central London",
      "lsoa11": "Camden 009A",
      "msoa11": "Camden 009",
      "lsoa21": "Camden 009A",
      "msoa21": "Camden 009",
      "oa21": "E00005884",
      "ruc11": "(England/Wales) Urban major conurbation",
      "ruc21": "Urban: Nearer to a major town or city",
      "lep1": "London",
      "lep2": null,
      "codes": {
        "admin_district": "E09000007",
        "admin_county": "E99999999",
        "admin_ward": "E05013664",
        "parish": "E43000197",
        "parliamentary_constituency": "E14001290",
        "parliamentary_constituency_2024": "E14001290",
        "ccg": "E38000240",
        "ccg_id": "93C",
        "ced": "E99999999",
        "nuts": "TLI36",
        "lsoa": "E01000866",
        "msoa": "E02000174",
        "lau2": "E09000007",
        "pfa": "E23000001",
        "nhs_region": "E40000003",
        "ttwa": "E30000234",
        "national_park": "E99999999",
        "bua": "E63007825",
        "icb": "E54000055",
        "cancer_alliance": "E56000011",
        "lsoa11": "E01000866",
        "msoa11": "E02000174",
        "lsoa21": "E01000866",
        "msoa21": "E02000174",
        "oa21": "E00005884",
        "ruc11": "A1",
        "ruc21": "UN1",
        "lep1": "E37000051",
        "lep2": null
      },
      "distance": 0
    },
    {
      "postcode": "NW1 9JH",
      "quality": 1,
      "eastings": 529227,
      "northings": 184533,
      "country": "England",
      "nhs_ha": "London",
      "longitude": -0.137824,
      "latitude": 51.544905,
      "european_electoral_region": "London",
      "primary_care_trust": "Camden",
      "region": "London",
      "lsoa": "Camden 009A",
      "msoa": "Camden 009",
      "incode": "9JH",
      "outcode": "NW1",
      "parliamentary_constituency": "Holborn and St Pancras",
      "parliamentary_constituency_2024": "Holborn and St Pancras",
      "admin_district": "Camden",
      "parish": "Camden, unparished area",
      "admin_county": null,
      "date_of_introduction": "198001",
      "admin_ward": "Kentish Town South",
      "ced": null,
      "ccg": "NHS North Central London",
      "nuts": "Camden",
      "pfa": "Metropolitan Police",
      "nhs_region": "London",
      "ttwa": "London",
      "national_park": null,
      "bua": "Greater London",
      "icb": "NHS North Central London Integrated Care Board",
      "cancer_alliance": "North Central London",
      "lsoa11": "Camden 009A",
      "msoa11": "Camden 009",
      "lsoa21": "Camden 009A",
      "msoa21": "Camden 009",
      "oa21": "E00005889",
      "ruc11": "(England/Wales) Urban major conurbation",
      "ruc21": "Urban: Nearer to a major town or city",
      "lep1": "London",
      "lep2": null,
      "codes": {
        "admin_district": "E09000007",
        "admin_county": "E99999999",
        "admin_ward": "E05013664",
        "parish": "E43000197",
        "parliamentary_constituency": "E14001290",
        "parliamentary_constituency_2024": "E14001290",
        "ccg": "E38000240",
        "ccg_id": "93C",
        "ced": "E99999999",
        "nuts": "TLI36",
        "lsoa": "E01000866",
        "msoa": "E02000174",
        "lau2": "E09000007",
        "pfa": "E23000001",
        "nhs_region": "E40000003",
        "ttwa": "E30000234",
        "national_park": "E99999999",
        "bua": "E63007825",
        "icb": "E54000055",
        "cancer_alliance": "E56000011",
        "lsoa11": "E01000866",
        "msoa11": "E02000174",
        "lsoa21": "E01000866",
        "msoa21": "E02000174",
        "oa21": "E00005889",
        "ruc11": "A1",
        "ruc21": "UN1",
        "lep1": "E37000051",
        "lep2": null
      },
      "distance": 30.43290554
    },
    {
      "postcode": "NW5 2AH",
      "quality": 1,
      "eastings": 529253,
      "northings": 184615,
      "country": "England",
      "nhs_ha": "London",
      "longitude": -0.137419,
      "latitude": 51.545636,
      "european_electoral_region": "London",
      "primary_care_trust": "Camden",
      "region": "London",
      "lsoa": "Camden 009A",
      "msoa": "Camden 009",
      "incode": "2AH",
      "outcode": "NW5",
      "parliamentary_constituency": "Holborn and St Pancras",
      "parliamentary_constituency_2024": "Holborn and St Pancras",
      "admin_district": "Camden",
      "parish": "Camden, unparished area",
      "admin_county": null,
      "date_of_introduction": "198001",
      "admin_ward": "Kentish Town South",
      "ced": null,
      "ccg": "NHS North Central London",
      "nuts": "Camden",
      "pfa": "Metropolitan Police",
      "nhs_region": "London",
      "ttwa": "London",
      "national_park": null,
      "bua": "Greater London",
      "icb": "NHS North Central London Integrated Care Board",
      "cancer_alliance": "North Central London",
      "lsoa11": "Camden 009A",
      "msoa11": "Camden 009",
      "lsoa21": "Camden 009A",
      "msoa21": "Camden 009",
      "oa21": "E00005888",
      "ruc11": "(England/Wales) Urban major conurbation",
      "ruc21": "Urban: Nearer to a major town or city",
      "lep1": "London",
      "lep2": null,
      "codes": {
        "admin_district": "E09000007",
        "admin_county": "E99999999",
        "admin_ward": "E05013664",
        "parish": "E43000197",
        "parliamentary_constituency": "E14001290",
        "parliamentary_constituency_2024": "E14001290",
        "ccg": "E38000240",
        "ccg_id": "93C",
        "ced": "E99999999",
        "nuts": "TLI36",
        "lsoa": "E01000866",
        "msoa": "E02000174",
        "lau2": "E09000007",
        "pfa": "E23000001",
        "nhs_region": "E40000003",
        "ttwa": "E30000234",
        "national_park": "E99999999",
        "bua": "E63007825",
        "icb": "E54000055",
        "cancer_alliance": "E56000011",
        "lsoa11": "E01000866",
        "msoa11": "E02000174",
        "lsoa21": "E01000866",
        "msoa21": "E02000174",
        "oa21": "E00005888",
        "ruc11": "A1",
        "ruc21": "UN1",
        "lep1": "E37000051",
        "lep2": null
      },
      "distance": 68.0938571
    }
  ]
}

Optional Query Parameters

Parameter	Description
limit	Limits number of postcodes to return. Defaults to 10. Maximum allowed is 100.
radius	Sets search radius in metres. Defaults to 100m. Maximum allowed is 2,000m.