Response Codes

All API responses will provide a HTTP Status Code.

  • 2xx - Successful responses
  • 4xx - Client error. Something was wrong with how the request was submitted. Users should alter the request before trying again.
  • 5xx - Server error. There is an issue on the Tive side of things. Please wait and try again later.

Error Codes

Below is a table of some common error codes that you may run into while using the Tive API. In some cases, an additional status message will accompany the status code providing more context into why the error occurred.

Status CodeDescription
400Bad Request. Tive cannot or will not process the request due to a client error. Common reasons include malformed requested, size too large, invalid request message framing, or deceptive request routing. Omitting the x-tive-account-id header on an endpoint which requires it will also result in 400 errors. See Accounts for more details.
401Unauthorized. The request cannot be completed as the user doesn't have the proper permissions.
403Forbidden. The client does not have access rights to the content. A common reason for this is specifying an incorrect account id (an account ID your API credentials do not have access to) in the x-tive-account-id header. See Accounts for more information.
429Too Many Requests. You have made too many requests within the allotted time. See Rate Limiting for more information.
5XXInternal Server Error. Tive servers are currently having an issue. Please try again later.