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": 1996,
"month_terminated": 6,
"eastings": 385386,
"northings": 801193,
"longitude": -2.242858,
"latitude": 57.101459
}
Reference
| Field | Type | Description | Example |
|---|---|---|---|
postcode | string | UK 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_terminated | integer | The year in which the postcode was terminated. | 1996 |
month_terminated | integer | The month in which the postcode was terminated (1-12 format, where 1 is January and 12 is December). | 6 |
eastings | integer | OS National Grid easting (1m resolution). Null for postcodes without a grid reference (e.g. Channel Islands, Isle of Man) or that were terminated before a reference was assigned. | 385386 |
northings | integer | OS National Grid northing (1m resolution). Null for postcodes without a grid reference (e.g. Channel Islands, Isle of Man) or that were terminated before a reference was assigned. | 801193 |
longitude | number | WGS84 longitude coordinate (east-west position) based on the postcode's national grid reference. | -2.242858 |
latitude | number | WGS84 latitude coordinate (north-south position) based on the postcode's national grid reference. | 57.101459 |