Address Verification

Address validation is crucial for sales tax calculations to ensure accuracy and compliance. Tax rates vary widely based on geographical jurisdictions, item taxability, and sourcing rules. An incorrect calculation can lead to over or underpaying taxes, which may result in legal issues and financial penalties. By validating addresses, businesses can confidently apply the correct tax rates, meet their legal obligations, and maintain the trust of their customers by providing transparent and fair pricing.

TaxCloud validates street addresses through our VerifyAddress API. Presently, our service only supports address validation within the United States, but we plan to extend it beyond the US in the future. Hence, we kindly ask our users to refrain from sending non-US addresses for verification at this time.

For proper and complete sales tax calculation, these data points are required:

1. Origin and delivery Street Address to determine the applicable sales tax jurisdictions.

2. Date of Sale to determine the applicable sales tax rates for each applicable jurisdiction.

3. Product or Service Category to determine if any product or use-based exemptions are available.

VerifyAddress API Required Parameters

A valid set of API Credentials is required. You can find your API credentials by logging into the TaxCloud portal and selecting Stores.

Sample Request

1
{
2
    "apiLoginID": "XXXXXXX",
3
    "apiKey": "XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
4
    "Address1": "162 East Ave",
5
    "Address2": "Third Floor",
6
    "City": "Norwalk",
7
    "State": "CT",
8
    "Zip5": "06851"
9
}

Sample Response # 1 (Verification Succeeded)

1
{
2
    "ErrNumber": "0",
3
    "ErrDescription": null,
4
    "Address1": "162 East Ave # 3",
5
    "Address2": null,
6
    "City": "Norwalk",
7
    "State": "CT",
8
    "Zip5": "06851",
9
    "Zip4": "5715"
10
}

Sample Response # 2 (Verification Failed)

1
{
2
  "ErrNumber": "97",
3
  "ErrDescription": "Address can't be verified",
4
  "Address1": null,
5
  "Address2": null,
6
  "City": null,
7
  "State": null,
8
  "Zip5": null,
9
  "Zip4": null
10
}

About VerifyAddress Responses

TaxCloud will not prevent checkout if address verification fails. Calculations will continue based on the information received but could be inaccurate if we’re missing the full address, including, street address, city or locality, state, and 9-digit postal code.

• If the ErrNumber = 0 = TaxCloud verified the address to use for future Lookup API calls.

• If the ErrNumber = [anything else] = TaxCloud could not verify the address, proceed with the customer-provided address for subsequent Lookup API calls. Verification can fail for a number of reasons - new or updated address or misspelling.

What’s Next?

Once you have verified your customer’s shipping or billing address, next is to make a sales tax Lookup call.