Lookup an Outward Code

This endpoint allows you to retrieve detailed information about a UK outward code (the first half of a postcode).

A successful request returns HTTP status code 200 and a JSON object containing comprehensive outward code data.

If the outward code is not found, the API returns a 404 response.

For more details, see the API Documentation

Endpoint

GET https://api.postcodes.io/outcodes/:outcode

Example Request

GET https://api.postcodes.io/outcodes/BR8

The above would match any of these inputs: "BR8", "br8", "Br8", etc.

Example Response

{
  "status": 200,
  "result": {
    "outcode": "BR8",
    "longitude": 0.17454313701431498,
    "latitude": 51.398688284253566,
    "northings": 168872,
    "eastings": 551367,
    "admin_district": [
      "Bromley",
      "Dartford",
      "Sevenoaks"
    ],
    "parish": [
      "Bromley, unparished area",
      "Crockenhill",
      "Farningham",
      "Hextable",
      "Sutton-at-Hone and Hawley",
      "Swanley"
    ],
    "admin_county": [
      "Kent",
      "(pseudo) England (UA/MD/LB)"
    ],
    "admin_ward": [
      "Crockenhill and Well Hill",
      "Farningham, Horton Kirby and South Darenth",
      "Hextable",
      "St Mary Cray",
      "St Paul's Cray",
      "Swanley Christchurch and Swanley Village",
      "Swanley St Mary's",
      "Swanley White Oak",
      "Wilmington, Sutton-at-Hone & Hawley"
    ],
    "country": [
      "England"
    ],
    "parliamentary_constituency": [
      "Orpington",
      "Sevenoaks"
    ]
  }
}