Find Nearest Outcode

Returns a list of outcodes nearest to the specified outcode, ordered by proximity.

Each result has the same shape as a standard outcode lookup. If the input outcode is not found, the API returns a 404 response code.

Endpoint

GET https://api.postcodes.io/outcodes/:outcode/nearest

Example Request

https://api.postcodes.io/outcodes/NW1/nearest

Example Response

{
  "status": 200,
  "result": [
    {
      "outcode": "NW1",
      "longitude": -0.1438658506650539,
      "latitude": 51.53338203264822,
      "northings": 183241,
      "eastings": 528839,
      "admin_district": [
        "Camden",
        "Westminster"
      ],
      "parish": [
        "Camden, unparished area",
        "Westminster, unparished area"
      ],
      "admin_county": [
        "(pseudo) England (UA/MD/LB)"
      ],
      "admin_ward": [
        "Bloomsbury",
        "Camden Square",
        "Camden Town",
        "Church Street",
        "Haverstock",
        "Hyde Park",
        "Kentish Town South",
        "King's Cross",
        "Marylebone",
        "Primrose Hill",
        "Regent's Park",
        "St Pancras & Somers Town",
        "West End"
      ],
      "country": [
        "England"
      ],
      "parliamentary_constituency": [
        "Cities of London and Westminster",
        "Holborn and St Pancras",
        "Queen's Park and Maida Vale"
      ]
    },
    {
      "outcode": "NW1W",
      "longitude": -0.135409513513515,
      "latitude": 51.530792687259556,
      "northings": 182968,
      "eastings": 529433,
      "admin_district": [
        "Camden"
      ],
      "parish": [
        "Camden, unparished area"
      ],
      "admin_county": [
        "(pseudo) England (UA/MD/LB)"
      ],
      "admin_ward": [
        "Regent's Park"
      ],
      "country": [
        "England"
      ],
      "parliamentary_constituency": [
        "Holborn and St Pancras"
      ]
    },
    {
      "outcode": "N1C",
      "longitude": -0.1258825243902439,
      "latitude": 51.53693576829269,
      "northings": 183668,
      "eastings": 530076,
      "admin_district": [
        "Camden"
      ],
      "parish": [
        "Camden, unparished area"
      ],
      "admin_county": [
        "(pseudo) England (UA/MD/LB)"
      ],
      "admin_ward": [
        "Camden Square",
        "King's Cross",
        "St Pancras & Somers Town"
      ],
      "country": [
        "England"
      ],
      "parliamentary_constituency": [
        "Holborn and St Pancras"
      ]
    }
  ]
}

Optional Query Parameters

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