UK Postcode Lookup API

Welcome to the UK Postcode Lookup API docs! Let us know if you have any feedback, feature requests or custom development needs.

Endpoint GET /{postcode}

Returns a single result containing location data based on the provided valid UK postcode.

Parameters

• postcode (required): A valid UK postcode.

Response

Status: 200 OK

Response example for a valid UK postcode.

{
  "result": {
    "ccg": "NHS North East London",
    "codes": {
      "admin_county": "E99999999",
      "admin_district": "E09000031",
      "admin_ward": "E05013892",
      "ccg": "E38000255",
      "ccg_id": "A3A8R",
      "ced": "E99999999",
      "lau2": "E09000031",
      "lsoa": "E01004401",
      "msoa": "E02000908",
      "nuts": "TLI53",
      "parish": "E43000221",
      "parliamentary_constituency": "E14001013",
      "pfa": "E23000001"
    },
    "country": "England",
    "date_of_introduction": "198001",
    "eastings": 535721,
    "european_electoral_region": "London",
    "incode": "5QJ",
    "latitude": 51.592789,
    "longitude": -0.042085,
    "lsoa": "Waltham Forest 014C",
    "msoa": "Waltham Forest 014",
    "nhs_ha": "London",
    "northings": 190031,
    "nuts": "Redbridge and Waltham Forest",
    "outcode": "E17",
    "parish": "Waltham Forest, unparished area",
    "parliamentary_constituency": "Walthamstow",
    "pfa": "Metropolitan Police",
    "postcode": "E17 5QJ",
    "primary_care_trust": "Waltham Forest",
    "quality": 1,
    "region": "London"
  },
  "status": 200
}

Status: 404 Not Found

Returned for an invalid UK postcode.

{
    "status": 404,Ï
    "error": "Invalid postcode"
}