Retrieve location TJIDs

Each taxing jurisdiction has a unique ID assigned to it, referred to as a TJID or jurisdictionId.

State/province TJIDs by country

This request returns all state or province TJIDs for a given country.

Request information

• HTTP method: GET
• URL (Replace countryId with the TJID for the country)
  • CertManager UAT: https://certmanager-uat.sovos.com/api/pre-auth/v1/locations/tax-jurisdictions/states/countryId
  • CertManager Production: https://certmanager.sovos.com/api/pre-auth/v1/locations/tax-jurisdictions/states/countryId

Country TJIDs

Use one of the following TJIDs for countryId:

• United States: 227
• Canada: 39

Example response

{
     "status": 200,
     "data": [
          {
               "code": 294,
               "name": "ALABAMA",
               "isocode": "AL",
               "type": 2,
               "parentCode": 227
          },
          {
               "code": 293,
               "name": "ALASKA",
               "isocode": "AK",
               "type": 2,
               "parentCode": 227
          },
          ...
     ],
     "success": true
}

Local TJIDs by state/province

This request returns all local TJIDs for a given state or province.

Request information

• HTTP method: GET
• Content-type header:
• URL (Replace stateId with the TJID for the state or province)
  • CertManager UAT: https://certmanager-uat.sovos.com/api/pre-auth/v1/locations/tax-jurisdictions/for-state/stateId
  • CertManager Production: https://certmanager.sovos.com/api/pre-auth/v1/locations/tax-jurisdictions/for-state/stateId

State TJIDs

Use one of the following TJIDs for stateId:

Example response

{
     "status": 200,
     "data": [
          {
               "code": 308,
               "name": "COVINGTON",
               "isocode": "COVINGTON",
               "type": 3,
               "parentCode": 294
          },
          {
               "code": 310,
               "name": "CULLMAN",
               "isocode": "CULLMAN",
               "type": 3,
               "parentCode": 294
          },
          ...
     ],
     "success": true
}