Outward Code Response Schema

The Outcode schema represents geographical and administrative information associated with a UK outward code (the first part of a postcode). This data is returned when using the outcode lookup endpoints.

Example

{
  "status": 200,
  "result": {
    "outcode": "SW1A",
    "longitude": -0.13218813888888895,
    "latitude": 51.504540465277756,
    "northings": 180054,
    "eastings": 529731,
    "admin_district": [
      "Wandsworth",
      "Westminster"
    ],
    "parish": [
      "Wandsworth, unparished area",
      "Westminster, unparished area"
    ],
    "admin_county": [
      "(pseudo) England (UA/MD/LB)"
    ],
    "admin_ward": [
      "Nine Elms",
      "St James's"
    ],
    "country": [
      "England"
    ],
    "parliamentary_constituency": [
      "Battersea",
      "Cities of London and Westminster"
    ]
  }
}

Reference

Field	Type	Description	Example
`outcode`	string	The outward code part of a postcode (2-4 characters). This generally identifies the postal town or district.	"SW1A"
`eastings`	integer \| null	Ordnance Survey grid reference easting (X-coordinate) averaged from all postcodes in the outcode. May be null if unavailable.	529993
`northings`	integer \| null	Ordnance Survey grid reference northing (Y-coordinate) averaged from all postcodes in the outcode. May be null if unavailable.	179950
`longitude`	number \| null	WGS84 longitude coordinate (east-west position) averaged from all postcodes in the outcode. May be null if unavailable.	-0.132759148
`latitude`	number \| null	WGS84 latitude coordinate (north-south position) averaged from all postcodes in the outcode. May be null if unavailable.	51.50100708
`admin_district`	string[]	List of administrative districts or unitary authorities that contain postcodes within this outcode.	["Westminster", "Camden"]
`admin_county`	string[]	List of administrative counties that contain postcodes within this outcode. May be empty for areas without county-level administration.	["(pseudo) England (UA/MD/LB)"]
`admin_ward`	string[]	List of electoral/administrative wards that contain postcodes within this outcode.	["St James's", "West End"]
`parish`	string[]	List of civil parishes (England) or communities (Wales) that contain postcodes within this outcode.	["Westminster, unparished area"]
`country`	string[]	List of UK constituent countries that contain postcodes within this outcode.	["England"]
`parliamentary_constituency`	string[]	List of UK Parliamentary constituencies (July 2024 boundaries) that contain postcodes within this outcode.	["Cities of London and Westminster", "Battersea"]

Example​

Reference​

Example

Reference