Validate postal addresses before sending mail to ensure deliverability.
We currently can only validate UK & US addresses.
| Parameter | Details | Description |
|---|---|---|
| company | str optional | Company name. |
| address1 | str required | Address line 1. |
| address2 | str optional | Address line 2. |
| city | str optional | Address city. Required if postal code is not provided. |
| province | str optional | Two-letter province abbreviation (ON, BC, QC, etc.). |
| zipcode | str optional | Address postal code. Required if city is not provided. |
| country | str optional | ISO 3166-1 Alpha 2 Country Code (CA,US,GB,FR...). Recommended for accurate validation. |
curl "https://api-us1.stannp.com/v1/addresses/validate" \
-u {API_KEY}: \
-d "company=Stannp" \
-d "address1=123 Main Street" \
-d "address2=Suite 100" \
-d "city=Toronto" \
-d "zipcode=M5H 2N2" \
-d "country=CA"{
"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
}
}