Address Validation API

Validate and standardize shipping addresses before creating labels.

Validate address

POST /v1/addresses/validate

Request body

Field	Type	Required	Description
street1	string	Yes	Street address
street2	string	No	Apt/Suite
city	string	Yes	City
state	string	Yes	State/province
zip	string	Yes	Postal code
country	string	Yes	Country code

Response

{
  "isValid": true,
  "standardized": {
    "street1": "456 OAK AVE",
    "city": "PORTLAND",
    "state": "OR",
    "zip": "97201-5723",
    "country": "US"
  },
  "corrections": [
    { "field": "zip", "original": "97201", "corrected": "97201-5723" }
  ],
  "residential": true
}

Validation results

Field	Description
isValid	Whether the address is deliverable
standardized	USPS-standardized address
corrections	List of corrections applied
residential	Whether the address is residential (affects carrier pricing)