Access to the Production API

API access requires a bearer token, which can be obtained using your Avatax account ID and license key.

To acquire a bearer token:

1. Create a License Key if not already created.
2. Call Avalara Identity to get an access token (choose based on your endpoint URL):

curl -X POST https://identity.avalara.com/connect/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=<avatax_account_id>&client_secret=<license key>&scope=hs-code-classification"

Sample response:

{
   "access_token": "<jwt_access_token>",
   "expires_in": 3600,
   "token_type": "Bearer",
   "scope": "hs-code-classification"
}

curl -X POST https://identity.avalara.com/connect/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=<avatax_account_id>&client_secret=<license key>&scope=avatax_api"

{
   "access_token": "<jwt_access_token>",
   "expires_in": 3600,
   "token_type": "Bearer",
   "scope": "avatax_api"
}

3. The access_token can be used to interact with the API.
4. The access_token is valid for 1 hour, after which you will need to request a fresh token.

Access to the Sandbox API

API access requires a bearer token, which can be obtained using your Avatax account ID and license key.

To acquire a bearer token:

1. Create a License Key if not already created.
2. Call Avalara Identity to get an access token (choose based on your endpoint URL):

curl -X POST https://ai-sbx.avlr.sh/connect/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=<avatax_account_id>&client_secret=<license key>&scope=hs-code-classification"

Sample response:

{
   "access_token": "<jwt_access_token>",
   "expires_in": 3600,
   "token_type": "Bearer",
   "scope": "hs-code-classification"
}

curl -X POST https://ai-sbx.avlr.sh/connect/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=<avatax_account_id>&client_secret=<license key>&scope=avatax_api"

{
   "access_token": "<jwt_access_token>",
   "expires_in": 3600,
   "token_type": "Bearer",
   "scope": "avatax_api"
}

3. The access_token can be used to interact with the API.
4. The access_token is valid for 1 hour, after which you will need to request a fresh token.

Note: The sandbox API is only available for a fixed number of classification requests.