Hire API rate limit
By default, the Hire API allows up to 120 requests per minute.
Rate limit information is returned in the HTTP headers of any Hire API request:
X-Api-Ratelimit-Limit: 120
X-Api-Ratelimit-Limit-Remaining: 19
X-Api-Ratelimit-Reset: 1461247812Use these headers to understand how your requests are being limited:
| Header | Description |
|---|---|
| X-Api-Ratelimit-Limit | The maximum number of requests per minute that you can make. |
| X-Api-Ratelimit-Limit-Remaining | The number of requests remaining in the current rate limit window. |
| X-Api-Ratelimit-Reset | The Unix time at which the rate limit resets. |
If your application exceeds this 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"
}
}If you need a higher rate limit
Contact [email protected] for help optimizing your API usage. Your Customer Success Manager can discuss single-tenant hosting and the rate limits available for your account.
For large datasets, ask your Customer Success Manager which Bulk APIs support your use case. Not every endpoint supports bulk requests.