Rate limits

The ThousandEyes API throttles API requests using a 240 request per minute (per organization) limit. The limit rolls over one minute from the first request in a batch, and starts again when the minute rolls over. These values are subject to change, as we work through identifying appropriate use patterns for our API.

Users can watch three header values in responses from the ThousandEyes API for information on rate limits:

HTTP/1.1 200 OK
X-Organization-Rate-Limit-Limit: 20
X-Organization-Rate-Limit-Remaining: 19
X-Organization-Rate-Limit-Reset: 1469560440
  • X-Organization-Rate-Limit-Limit is the number of requests allowed for your organization in a 60-second period.
  • X-Organization-Rate-Limit-Remaining is the number of requests remaining in the current 60-second period.
  • X-Organization-Rate-Limit-Reset is the UTC timestamp of the next rate limit rollover.

Instant Tests Rate Limits

Instant tests are governed through a separate set of throttling controls, and allow up to 24 calls per minute. Instant test rate limit headers can be found below:

X-Instant-Test-Rate-Limit-Limit: 2
X-Instant-Test-Rate-Limit-Remaining: 1
X-Instant-Test-Rate-Limit-Reset: 1469560440

As above:

  • X-Instant-Test-Rate-Limit-Limit is the number of requests allowed for your organization in a 60-second period.
  • X-Instant-Test-Rate-Limit-Remaining is the number of requests remaining in the current 60-second period.
  • X-Instant-Test-Rate-Limit-Reset is the UTC timestamp of the next rate limit rollover.

Template Deployment Rate Limits

The /templates/{id}/deploy operation has its own rate limiting applied. The following headers provide information specific to this operation:

HTTP/1.1 429 Too Many Requests
X-Template-Deploy-Rate-Limit-Limit: 5
X-Template-Deploy-Rate-Limit-Remaining: 4
X-Template-Deploy-Rate-Limit-Reset: 10
  • X-Template-Deploy-Rate-Limit-Limit is the maximum number of template deployment requests allowed within a specified time frame. The limit is 5 requests per minute.
  • X-Template-Deploy-Rate-Limit-Remaining is the number of remaining template deployment requests allowed within the current time frame. This value represents how many of the 5 requests per minute are still available.
  • X-Template-Deploy-Rate-Limit-Reset is the time remaining until the rate limit resets, restoring the full quota of requests. A value of 0 indicates that the rate limit has reset and access is currently allowed.

Note: If you receive an HTTP 429 (Too Many Requests) response code, this is due to rate limiting. Wait until the value specified in either the X-Organization-Rate-Limit-Reset or X-Instant-Test-Rate-Limit-Reset header (depending on your request type) before retrying.

For information on error codes and responses, see Response status codes.