Address Validation API

// Search for Address to Validate
curl -X GET "https://wsp.epostcode.com/uk/v1/Search?key=YOUR_API_KEY_HERE&phrase=10%20Downing%20Street%20London&opensearch=true"

// JavaScript (Fetch)
fetch('https://wsp.epostcode.com/uk/v1/Search?key=YOUR_API_KEY_HERE&phrase=10 Downing Street London&opensearch=true')
.then(response => response.json())
.then(data => {
  console.log(data);
  // Validate address match
  if (data.items && data.items.length > 0) {
    const validAddress = data.items[0];
    console.log('Valid:', validAddress.text);
    console.log('Type:', validAddress.type); // 'Premise' or 'Group'
    
    // If it's a premise, get full details
    if (validAddress.type === 'Premise') {
      fetch(`https://wsp.epostcode.com/uk/v1/GetPremise?key=YOUR_API_KEY_HERE&id=${validAddress.key}`)
      .then(response => response.json())
      .then(premiseData => {
        console.log('Address:', premiseData.item);
        console.log('Lat/Long:', premiseData.item.lat, premiseData.item.long); // FREE
      });
    }
  }
});

// JSON Response - GetPremise (Default - lat/long FREE)
{
  "item": {
    "id": "52502003",
    "buildingName": "Merlin House",
    "street": "Mossland Road",
    "city": "Glasgow",
    "postalCode": "G52 4XZ",
    "lat": "55.863168",    // ✓ Latitude included FREE
    "long": "-4.379078"    // ✓ Longitude included FREE
  }
}

// To include UPRN data, add uprn=true (+1 extra credit)
// GET /GetPremise?key=YOUR_API_KEY&id=52502003&uprn=true
{
  "item": {
    "id": "52502003",
    "lat": "55.863168",
    "long": "-4.379078",
    "uprn": "123105666",   // ✓ UPRN included (+1 credit)
    "udprn": "52502003"
  }
}