Rate Limits

By default you can make up to 120 requests per minute.

Rate limit information is returned in the HTTP headers of any API request:

X-Api-Ratelimit-Limit: 120
X-Api-Ratelimit-Limit-Remaining: 19
X-Api-Ratelimit-Reset: 1461247812

Use these headers to understand how your requests are being limited:

HeaderDescription
X-Api-Ratelimit-LimitThe maximum number of requests per minute that you can make.
X-Api-Ratelimit-Limit-RemainingThe number of requests remaining in the current rate limit window.
X-Api-Ratelimit-ResetThe Unix time at which the rate limit will reset to its maximum.

If your application triggers this rate limit, you'll receive the following response:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json; charset=utf-8

{
  "error": {
    "msg":"Too many API requests. See documentation for more information",
    "name":"exceeded_rate"
  }
}

📘

Questions about the Fountain Hire API rate limit?

If the current Hire API rate limit is not sufficient for your use cases, please contact [email protected]. We can help you optimize your current usage and discuss alternative options.