Overview

This page offers an introduction to the most common errors you may encounter. In our API References, each endpoint lists all of its potential errors. If you receive an error that is not listed here, please look at the specific endpoint for more thorough documentation or reach out to support@extole.com.

Error Structure

The basic structure of an error response from Extole is that it will return a different HTTP code than 200, typically in the 4xx or 500 range.

Standard Error Parameters

Field	Description
`unique_id`	A unique error identifier from Extole that can be used by Extole to correlate this with the Extole error log.
`http_status_code`	The HTTP status code that was returned. In an error scenario it will be 4xx or 500 error.
`code`	A string enum for the error code: `access_denied` `missing_access_token`
`message`	A human-readable error message.
`parameters.reason`	Sub error: A string enum for an error condition.
`parameters.description`	Sub error: A human-readable description of the error condition.

Common Errors

Each endpoint has unique errors, but below are several of the most common error conditions that are returned.

{
  "unique_id": "6941047907334948670",
  "http_status_code": 400,
  "code": "validation_error",
  "message": "Validation failed",
  "parameters": {
    "description": "must not be null"
  }
}

{
  "unique_id": "6941049359794271324",
  "http_status_code": 403,
  "code": "missing_access_token",
  "message": "No access_token was provided with this request.",
  "parameters": {}
}

{
  "unique_id": "6928128588868954308",
  "http_status_code": 400,
  "code": "invalid_json",
  "message": "JSON is invalid",
  "parameters": {}
}

Rate Limiting and Frequency Capping

A 429 error means "Too Many Requests," indicating that your end users have sent too many requests in a given amount of time and is being rate-limited by the server.

Extole APIs support 100 requests made in one minute by a single IP address or token. We also support 10 requests per second per identified person.

Typical reasons you may exceed the request limits and receive 429 errors are:

There is an issue with your tag integration. For example, you may have left dummy/example values for your data parameters or your customer data platform is misconfigured to send us too much information.
You're conducting load testing or security scans. It is expected that you will run into rate limiting when in these cases.

If you have questions about our rate limiting or are experiences issues, please reach out to support@extole.com.