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
Successful Response
Unprocessable Entity
Server Error
curl -i -X GET \ 'https://api.goshippo.com/v2/addresses/validate?name=Wilson&organization=Shippo&address_line_1=731%20Market%20Street&address_line_2=%23200&city_locality=San%20Francisco&state_province=CA&postal_code=94103&country_code=US' \ -H 'Authorization: ShippoToken <API_TOKEN>'
{- "original_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "city_locality": "string",
- "state_province": "string",
- "postal_code": "string",
- "country_code": "string",
- "name": "string",
- "organization": "string",
- "phone": "string",
- "email": "user@example.com"
}, - "recommended_address": {
- "address_line_1": "string",
- "address_line_2": "string",
- "city_locality": "string",
- "state_province": "string",
- "postal_code": "string",
- "country_code": "string",
- "name": "string",
- "organization": "string",
- "phone": "string",
- "email": "user@example.com",
- "complete_address": "string",
- "confidence_result": {
- "score": "high",
- "code": "string",
- "description": "string"
}
}, - "analysis": {
- "validation_result": {
- "value": "valid",
- "reasons": [ ]
}, - "address_type": "unknown",
- "changed_attributes": [
- "address_line_1"
]
}, - "geo": {
- "latitude": 0,
- "longitude": 0
}
}