Stannp | Direct Mail Marketing Platform

Addresses

Validate postal addresses before sending mail to ensure deliverability.

Validate an address

We currently can only validate UK & US addresses.

POST

Parameters

ParameterDetailsDescription
company
str optional
Company name.
address1
str required
Address line 1.
address2
str optional
Address line 2.
address3
str optional
Address line 3.
city
str optional
Address city.
postcode
str optional
Address postal code. Recommended for accurate validation.
country
str optional
ISO 3166-1 Alpha 2 Country Code (GB,US,FR...). Recommended for accurate validation.

Request Example

curl "https://api-eu1.stannp.com/v1/addresses/validate" \
-u {API_KEY}: \
-d "company=Stannp" \
-d "address1=Unit 12" \
-d "address2=Taw trade park" \
-d "city=Barnstaple" \
-d "postcode=EX31 1JZ" \
-d "country=GB"

Response Example

{
  "success": true,
  "data": {
    "address1": "Unit 12 Taw Trade Park",
    "address2": "",
    "address3": "",
    "city": "Barnstaple",
    "county": "Devon",
    "postcode": "EX31 1JZ",
    "country": "GB",
    "reference_id": 0,
    "dps": "1A",
    "udprn": "12345678",
    "is_valid": true
  }
}