---
title: "Lookup Terminated Postcodes"
method: GET
path: "/terminated_postcodes/{postcode}"
tags: ["Terminated Postcodes"]
---

# Lookup Terminated Postcodes

`GET /terminated_postcodes/{postcode}`

Lookup a terminated postcode.

If the terminated postcode exists, this API returns the year and month of termination plus its last known WGS84 coordinates. Channel Islands and Isle of Man postcodes do not carry coordinates — `longitude` and `latitude` will be `null` for those.

Returns `404` if the postcode does not exist in our database of terminated postcodes or is not valid.

Source: ONS Postcode Directory (ONSPD). Live and terminated postcodes share the same underlying table; a postcode is terminated when `date_of_termination` is set.

## Path parameters

- `postcode` string, required

## Response `200`

Success

- TerminatedPostcodeResponse
  - `status` 200, required
  - `result` TerminatedPostcode, required
    - `postcode` string, required — UK postal code format that has been terminated. Follows the standard format of 2-4 character outward code, a space, then 3-character inward code.
    - `year_terminated` integer, required — The year when the postcode was terminated (YYYY format).
    - `month_terminated` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12, required — Month when the postcode was terminated (1-12, where 1=January, 12=December).
    - `eastings` integer, nullable, required — 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.
    - `northings` integer, nullable, required — 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.
    - `longitude` number, double, nullable, required — WGS84 longitude coordinate of the postcode location. Null if no grid reference is available.
    - `latitude` number, double, nullable, required — WGS84 latitude coordinate of the postcode location. Null if no grid reference is available.

## Other responses

- `404` — Postcode not found

---

[API](https://skmtc.net/postcodes/apis/api-reference-postcodes-io.md) · [All operations](https://skmtc.net/postcodes/apis/api-reference-postcodes-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postcodes/api-reference-postcodes-io/versions/48aff276e237/schema)