Choose the right postage when sending on the API Are you sending personal information, or marketing content? Before you send your mail, know the key difference between First-Class and USPS Marketing Mail. Read our blog to find out more.
Addresses
Validate postal addresses before sending mail to ensure deliverability.
Validate an address
We currently can only validate UK & US addresses.
POST
Parameters
| 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 zipcode is not provided. |
| state | str optional | Two-letter abbreviation if possible. |
| zipcode | str optional | Address zipcode. Required if city is not provided. |
| country | str optional | ISO 3166-1 Alpha 2 Country Code (US,GB,CA,FR...). Recommended for accurate validation. |
Request Example
curl "https://api-us1.stannp.com/v1/addresses/validate" \
-u {API_KEY}: \
-d "company=Stannp" \
-d "address1=1000 N west street" \
-d "address2=Suite 1200 #1939" \
-d "city=Wilmington" \
-d "zipcode=19801" \
-d "country=US"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
}
}