Too Many Requests (429)

This error code is returned when the user has exceeded their allotted requests for a given time interval. The TruSTAR API implements two types of limits:

  1. Short-term rate limiting as a safeguard against over-use of the system.
  2. Longer-term quotas that can be set on a company-by-company basis.

When this error is returned, the response body will contain a field called waitTime, which represents the number of milliseconds that the user must wait before making another request.

The Get Request Quotas endpoint can be used to observe the details of a company’s request quotas. See https://support.trustar.co/article/m5kl5anpiz-api-rate-limit-quota for more details.

Sample JSON

{
    "message": "Request limit exceeded for the current time period.  Please wait 4243 milliseconds before making more requests.",
    "waitTime": 4243
}