How can we help?

Show Page Sections

Connect to Sovos

Connect to the Sovos developer portal

The Sovos developer portal provides access to app registration and authentication services, making sure businesses remain compliant with tax regulations through the TINCheck REST API.

The TINCheck REST API lets businesses remain compliant by delivering real-time updates and adjustments. Sovos monitors tax regulations, making sure the API is always updated with the latest requirements.

To start using TINCheck REST API, you must:
  • Create a account in the production environment of the developer portal

  • Create an app in the API Admin that lets you generate an API key and a secret

  • Copy the authentication keys (API key and secret) from your app

  • Generate an authentication token to use most API endpoints

Create a developer account

To integrate with the TINCheck REST API for the first time, you need to create an account in the production environment of the API Admin.
  1. Go to the production registration page.
  2. Enter the required information.
    Tip:

    When entering the phone number, make sure to include the country code (+##).

  3. To read the Sovos terms, click the Developer Terms and Conditions link. Then, select the checkbox to agree.
  4. Click Create profile.
  5. Go to your inbox, and click the verification email you received form Sovos.
  6. In the email, click Verify.
  7. Enter and confirm your password.
    The password must:
    • Be at least ten characters long

    • Include one uppercase letter, one lowercase letter, and one number

    • Include at least one special character: #@$!%*?&+~|{}:.-;<>/_

    • Not contain any spaces

  8. Set up two-factor authentication by following the prompts on the page.
You are logged into the the API Admin.

Create an app in the API Admin

Create an app to generate the authentication keys (API key and Secret) you will need in the production environment of the TINCheck REST API.
  1. Log in to the production environment of the API Admin.
  2. Click the region dropdown and select North America.
    The Region dropdown field and the North America option are highlighted.
  3. Click Apps in the menu, then click + App.
  4. Enter a name and description for your app.
  5. In the APIs section, click Enable in the Actions column of the APIs you will be working with.
  6. Click Save.
You will get a success message and will be redirected to the Apps page.

Copy the authentication keys

After creating an app, you must copy the authentication keys, which are needed for generating the OAuth token in most endpoints.
  1. Log in to the production environment of the API Admin.
  2. Click the region dropdown and select North America.
    The Region dropdown field and the North America option are highlighted.
  3. Click Apps in the menu.
  4. Click the name of the app you want to copy the authentication keys for.
  5. In the API Keys section, click the Copy icons in the Key and Secret columns to get the values.
    The Copy icons in the Key and Secret columns are highlighted.