Skip to main content

Terminated Postcode Response Schema

The Terminated Postcode schema provides information about UK postcodes that are no longer in use. This data is returned when using the terminated postcode lookup endpoints.

Example

{
"postcode": "AB1 0AA",
"year_terminated": 2018,
"month_terminated": 6,
"longitude": -2.242851,
"latitude": 57.101474
}

Reference

FieldTypeDescriptionExample
postcodestringUK postcode format: 2-4 character outward code, a space, and a 3-character inward code. All terminated postcodes within the UK, Channel Islands and Isle of Man, updated quarterly from Royal Mail."AB1 0AA"
year_terminatedintegerThe year in which the postcode was terminated.2018
month_terminatedintegerThe month in which the postcode was terminated (1-12 format, where 1 is January and 12 is December).6
longitudenumberWGS84 longitude coordinate (east-west position) based on the postcode's national grid reference.-2.242851
latitudenumberWGS84 latitude coordinate (north-south position) based on the postcode's national grid reference.57.101474