Postcode Lookup API

// cURL Request
curl -X GET "https://wsp.epostcode.com/uk/v1/Search?key=YOUR_API_KEY_HERE&query=SW1A%201AA"

// JavaScript (Fetch)
fetch('https://wsp.epostcode.com/uk/v1/Search?key=YOUR_API_KEY_HERE&query=SW1A 1AA')
.then(response => response.json())
.then(data => {
  console.log(data);
  // Access results array
  data.items.forEach(address => {
    console.log(address.address);
  });
})
.catch(error => console.error('Error:', error));

// JSON Response - Search Endpoint
{
  "results": [
    {
      "id": "12345678",
      "address": "10 Downing Street, Westminster, London, SW1A 2AA",
      "buildingName": "",
      "buildingNumber": "10",
      "street": "Downing Street",
      "locality": "Westminster",
      "town": "London",
      "county": "Greater London",
      "postcode": "SW1A 2AA",
      "country": "England"
    }
  ],
  "totalResults": 1
}

// Get Detailed Data with Lat/Long (FREE) and UPRN (+1 credit)
// Use the 'id' from search results to get full premise details
GET /GetPremise?id=12345678

// JSON Response - GetPremise Endpoint
{
  "premise": {
    "id": "12345678",
    "uprn": "10001234567",        // +1 credit if requested
    "buildingName": "",
    "buildingNumber": "10",
    "subBuildingName": "",
    "street": "Downing Street",
    "locality": "Westminster",
    "town": "London",
    "county": "Greater London",
    "postcode": "SW1A 2AA",
    "postcodeInward": "2AA",
    "postcodeOutward": "SW1A",
    "country": "England",
    "latitude": 51.503396,        // FREE - Included
    "longitude": -0.127764,       // FREE - Included
    "eastings": 530047,
    "northings": 179951
  }
}