HSCode classification service

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:

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

hscode.api.avalara.com — 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=hs-code-classification"

Sample response:

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

hscode.avatax.avalara.com (legacy) — scope: avatax_api

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"

Sample response:

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

The access_token can be used to interact with the API.
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:

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

hscode.api.sbx.avalara.com — 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=hs-code-classification"

Sample response:

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

hscode.avatax.sbx.avalara.com (legacy) — scope: avatax_api

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"

Sample response:

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

The access_token can be used to interact with the API.
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.

Check top 10 endpoints

public

Open Console