Validate address
Returns validation test results along with a recommended address. Validates both US and international addresses.
US required combinations
- state_province + city_locality + address_line_1
- or address_line_1 + postal_code
International required combinations
- city_locality + address_line_1
Authorizations
Enter your shippo token with the ShippoToken prefix.
Example: ShippoToken shippo_live_xxxx
Query Parameters
The name of the addressee
64"Wilson"
The organization of the addressee
100"Shippo"
The first line of the address
1 - 100"731 Market Street"
The second line of the address. Must be percent encoded when passed as a query parameter (e.g. #200 → %23200).
50"#200"
The city or locality of the address
64"San Francisco"
The state, province, county, or municipal division
32"CA"
The postal code or zip code
16"94103"
The ISO 3166 country code
AE, AR, AT, AU, AX, AZ, BA, BD, BE, BG, BH, BM, BN, BR, BS, BW, BY, CA, CH, CL, CO, CN, CY, CZ, DE, DK, EC, EE, EG, ES, FI, FO, FR, GB, GE, GF, GG, GI, GP, GR, GU, HK, HR, HU, ID, IE, IL, IM, IN, IS, IT, JE, JO, JP, KR, KY, KW, KZ, LB, LI, LT, LU, LV, MA, MC, MD, ME, MK, MO, MP, MQ, MT, MX, MY, NA, NL, NO, NZ, OM, PE, PH, PL, PM, PR, PT, PY, QA, RE, RO, RU, SA, SC, SE, SG, SI, SK, SM, SR, TH, TN, TR, TW, UA, US, UY, VN, WE, YT, ZA "US"
Response
Successful Response