Authentication Errors

FREE Plan - Credits Exhausted

FREE plan accounts receive an error after consuming their allocated amount of free credits.

Error example:

//Error code: 403
{
    You have reached the limit of 10000 credits with your free plan for '####'.
    Upgrade your plan at https://co.tatum.io/3JjG5Ih
}

📘

If you get this error and have a free plan, you will need to upgrade your account - Pricing page.

Unauthenticated Request

Tatum requires users to authenticate all requests, where each request has a cost in credits.

Error example:

 url: '#####',
  status: 401,
  statusText: 'Unauthorized',
  body: {
    statusCode: 401,
    errorCode: 'ip-address-key.unauthorized',
    message: "Authentication required. Make sure your requests are authenticated with a Tatum API key. Find out how at: https://docs.tatum.io/docs/authentication. If you don't have one, get one for FREE via the Tatum Dashboard at https://dashboard.tatum.io."
  }

📘

If you have a paid plan and get this error, make sure you are authenticating your requests. Additional information is available in the following article.