v1

latestOpenAPI 3.1.0MIT2026-07-13111497.3 KB
Postcode Query

Bulk Postcode Lookup

Accepts a JSON object containing an array of postcodes. Returns a list of matching postcodes and respective available data.

Be sure to submit JSON requests setting Content-Type to application/json.

Accepts up to 100 postcodes.

Post Data

This method requires a JSON object containing an array of postcodes to be posted, e.g.

{
  "postcodes": ["PR3 0SG", "M45 6GN", "EX16 5BL"]
}

Bulk Reverse Geocoding

Bulk translates geolocations into Postcodes. Accepts up to 100 geolocations.

post/postcodes

Response

Success

status200 required

Example response

{
  "result": {
    "postcode": "SW1A 2AA",
    "outcode": "SW1A",
    "incode": "1AA",
    "quality": 1,
    "eastings": 530047,
    "northings": 179951,
    "country": "England",
    "nhs_ha": "London",
    "admin_district": "Westminster",
    "admin_ward": "St. James's",
    "longitude": -0.12767,
    "latitude": 51.503541,
    "parliamentary_constituency": "Cities of London and Westminster",
    "european_electoral_region": "London",
    "primary_care_trust": "Westminster",
    "region": "London",
    "parish": "Westminster, unparished area",
    "lsoa": "Westminster 018C",
    "msoa": "Westminster 018",
    "ccg": "NHS North West London",
    "pfa": "Metropolitan Police",
    "date_of_introduction": "198001",
    "index_of_multiple_deprivation": 14843,
    "parliamentary_constituency_2024": "Cities of London and Westminster",
    "senedd_constituency": "Caerdydd Penarth",
    "senedd_constituency_no": 14,
    "nhs_region": "London",
    "ttwa": "London",
    "bua": "Greater London",
    "icb": "NHS North West London Integrated Care Board",
    "cancer_alliance": "RM Partners (West London)",
    "lsoa11": "Westminster 018C",
    "msoa11": "Westminster 018",
    "lsoa21": "Westminster 018C",
    "msoa21": "Westminster 018",
    "oa21": "E00004185",
    "ruc11": "Urban major conurbation",
    "ruc21": "Urban major conurbation",
    "lep1": "London",
    "nuts": "Westminster",
    "codes": {
      "admin_district": "E09000033",
      "admin_county": "E99999999",
      "admin_ward": "E05013806",
      "parish": "E43000236",
      "ccg": "E38000256",
      "ccg_id": "W2U3Z",
      "ced": "E99999999",
      "nuts": "TLI32",
      "lau2": "E09000033",
      "lsoa": "E01004736",
      "msoa": "E02000977",
      "pfa": "E23000001",
      "parliamentary_constituency": "E14000639",
      "parliamentary_constituency_2024": "E14000639",
      "nhs_region": "E40000003",
      "ttwa": "E30000234",
      "bua": "E34004786",
      "icb": "E54000027",
      "cancer_alliance": "E56000009",
      "lsoa11": "E01004736",
      "msoa11": "E02000977",
      "lsoa21": "E01004736",
      "msoa21": "E02000977",
      "oa21": "E00004185",
      "ruc11": "A1",
      "ruc21": "A1",
      "lep1": "E37000051"
    }
  }
}