Addresses

Valid addresses are crucial for accurate sales tax calculations. By validating addresses before collecting taxes, you ensure calculations are based on precise location data and prevent filing issues.

POST/addresses

Validate address

This endpoint takes an address and returns the validated address and coordinates. Use it to confirm customer addresses before calculating taxes. Only US addresses are supported.

Request

Name
line1
Type
string
Name
line2
Type
string (optional)
Name
city
Type
string
Name
state
Type
string (2-letter)
Name
zip
Type
string (##### or #####-####)
Name
country
Type
string (optional, default: US)

Response

Name
200
Type
Address is valid
﹣ Hide response
Collapsable section
Name
originalAddress
Type
address
＋ Show child properties
Name
validatedAddress
Type
address with coordinates
＋ Show child properties
Name
200
Type
Address not found
＋ Show response

A lookup is considered successful (status code: 200) if the request meets requirements and there are no system failures. If the address is valid, the validatedAddress is populated with the validated address and coordinates. An address is invalid if the validatedAddress is null.

Request

POST

/addresses

{
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612"
}

Response

{
  "originalAddress": {
    "line1": "120 SW 10TH AVE",
    "line2": null,
    "city": "TOPEKA",
    "state": "KS",
    "zip": "66612",
    "country": "US"
  },
  "validatedAddress": {
    "coordinates": [
      -95.67659,
      39.046513
    ],
    "line1": "120 SW 10th Ave",
    "line2": null,
    "city": "Topeka",
    "state": "KS",
    "zip": "66612-1226",
    "country": "US"
  }
}