For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Help CenterSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Getting Started
    • Overview
    • How TaxCloud Works
    • Migrating from API v1 to v3
  • Integration Basics
    • Getting Started with TaxCloud Integration
  • API Guides
    • Verify an Address
    • Lookup Sales Tax
    • Complete an Order
Help CenterSign Up
On this page
  • VerifyAddress API Required Parameters
  • Sample Request
  • Sample Response # 1 (Verification Succeeded)
  • Sample Response # 2 (Verification Failed)
  • About VerifyAddress Responses
  • What’s Next?
API Guides

Address Verification

Was this page helpful?
Previous

Lookup Sales Tax

Next
Built with

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.

ParameterDescriptionExample
apiLoginIDYour unique 7 or 8 character API IDXXXXXXX
apiKeyYour unique API KEYXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Address1Numbered Street Address162 East Ave
Address2Apartment, Suite, Floor, etc.Third Floor
CityCity NameNorwalk
StateState NameCT
Zip55-digit Zip Code06851

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.