Postcodes
Get a Random Postcode
Returns a randomly selected postcode along with comprehensive geographic, administrative, and statistical data associated with that postcode.
get/random/postcodes
Query parameters
outcodestring
Example:SW1A
Filters random postcodes by outcode. Returns null if invalid outcode.
Response
Success
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"
}
}
}