curl --request GET \
--url https://api.addressy.com/GovernmentData/Postzon/RetrieveByCoordinates/v1.20/json6.ws{
"Items": [
{
"Postcode": "WR2 6NJ",
"Easting": "381600",
"Northing": "259400",
"Latitude": "52.2325",
"Longitude": "-2.2709",
"OsGrid": "SO 81600 59400",
"CountryCode": "064",
"CountryName": "England",
"CountyCode": "47",
"CountyName": "Worcestershire",
"DistrictCode": "47UC",
"DistrictName": "Malvern Hills",
"WardCode": "47UCHW",
"WardName": "Hallow",
"NhsShaCode": "Y51",
"NhsShaName": "North, Midlands and the East Programme for IT (NMEPFiT)",
"NhsPctCode": "5PL",
"NhsPctName": "Worcestershire PCT",
"LeaCode": "885",
"LeaName": "Worcestershire",
"GovernmentOfficeCode": "F",
"GovernmentOfficeName": "West Midlands",
"WestminsterConstituencyCode": "505",
"WestminsterConstituencyName": "West Worcestershire",
"WestminsterMP": "Sir Michael Spicer",
"WestminsterParty": "Conservative",
"Distance": "0",
"WestminsterConstituencyCode2010": "505",
"WestminsterConstituencyName2010": "West Worcestershire"
}
]
}GovernmentData: Postzon RetrieveByCoordinates
Find nearest UK postcode and government data from coordinates. Returns ONS codes, NHS areas, constituencies, wards, and administrative boundaries.
curl --request GET \
--url https://api.addressy.com/GovernmentData/Postzon/RetrieveByCoordinates/v1.20/json6.ws{
"Items": [
{
"Postcode": "WR2 6NJ",
"Easting": "381600",
"Northing": "259400",
"Latitude": "52.2325",
"Longitude": "-2.2709",
"OsGrid": "SO 81600 59400",
"CountryCode": "064",
"CountryName": "England",
"CountyCode": "47",
"CountyName": "Worcestershire",
"DistrictCode": "47UC",
"DistrictName": "Malvern Hills",
"WardCode": "47UCHW",
"WardName": "Hallow",
"NhsShaCode": "Y51",
"NhsShaName": "North, Midlands and the East Programme for IT (NMEPFiT)",
"NhsPctCode": "5PL",
"NhsPctName": "Worcestershire PCT",
"LeaCode": "885",
"LeaName": "Worcestershire",
"GovernmentOfficeCode": "F",
"GovernmentOfficeName": "West Midlands",
"WestminsterConstituencyCode": "505",
"WestminsterConstituencyName": "West Worcestershire",
"WestminsterMP": "Sir Michael Spicer",
"WestminsterParty": "Conservative",
"Distance": "0",
"WestminsterConstituencyCode2010": "505",
"WestminsterConstituencyName2010": "West Worcestershire"
}
]
}Query Parameters
The key to use to authenticate to the service.
A postcode or coordinates (latitude, longitude or easting, nothing) of the centre of the search.
The username associated with the Royal Mail license (not required for click licenses).
Response
Success
Show child attributes
Show child attributes
The postcode that is nearest to the given location.
The easting coordinate of the location. Represents a distance in meters east from the most south westerly position of the GB mapping grid.
The northing coordinate of the location. Represents a distance in meters north from the most south westerly position of the GB mapping grid.
The WGS84 latitude coordinate of the location.
The WGS84 longitude coordinate of the location.
The OS grid reference for the location.
The ONS country code for the location.
The name corresponding to CountryCode.
The ONS county code for the location. For locations without 2 tier local administration, this will be 00.
The name corresponding to CountyCode.
The ONS district code for the location.
The name corresponding to DistrictCode.
The ONS ward code for the location.
The name corresponding to WardCode.
The ONS code for the NHS Strategic Health Authority for the location.
The name corresponding to NhsShaCode.
The ONS code for the NHS Primary Care Trust for the location.
The name corresponding to NhsPctCode.
The ONS code for the Local Education Authority for the location.
The name corresponding to LeaCode.
The ONS code for the Government Office for the location.
The name corresponding to GovernmentOfficeCode.
The ONS code for the Westminster parliamentary constituency for the location.
The name corresponding to WestminsterConstituencyCode.
The name of the Westminster Member of Parliament for the location.
The party for WestminsterMP.
The straightline distance in metres from the centre point of the search to this record.
The ONS code (or temporary if > 900) for the Westminster parliamentary constituency for the location in 2010.
The name corresponding to WestminsterConstituencyCode2010.
Was this page helpful?