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.13226037062937065,
"latitude": 51.504530636363654,
"northings": 180053,
"eastings": 529727,
"admin_district": [
"Westminster",
"Wandsworth"
],
"parish": [
"Wandsworth, unparished area",
"Westminster, unparished area"
],
"admin_county": [],
"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. | [] |
| `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"] |