Rate limits

Making too many requests to the SafetyCulture API

To ensure the stability and security of our servers requests sent to the API by the same user simultaneously at a high rate will be throttled. In that case the API will return a 429 HTTP status code with an error message Too Many Requests.

Our rate limiting policy consists of a hard throttling limit

EndpointRateInterval
POST /users/search20060 seconds
GET /share/connections20060 seconds
POST /audits3060 seconds
GET /audits/search20060 seconds
GET /export_profiles/search20060 seconds
GET /templates/search20060 seconds
GET /response_sets20060 seconds
POST /audits/<audit ID>/export2060 seconds
GET /audits/<audit ID>/exports/<export ID>10060 seconds
GET /audits/<audit ID>/exports/<export ID>/<filename>10060 seconds
GET /preferences/search20060 seconds
POST /audits/{audit ID}/report20060 seconds
GET /audits/{audit ID}/report/{export ID}20060 seconds
POST /users/v1/users/upsert560 seconds
POST /users/v1/users/upsert/jobs20060 seconds
POST /users/v1/users/upsert/jobs/{job_id}560 seconds
DELETE /users/v1/users/upsert/jobs/{job_id}20060 seconds
GET /users/v1/users/upsert/jobs/{job_id}20060 seconds
POST /users/v1/users/upsert/jobs/list20060 seconds
GET /training/collections/v120060 seconds
GET /training/collections/v1/{collection ID}/courses20060 seconds
GET /training/courses/v120060 seconds
GET /training/courses/v1/{course ID}/lessons20060 seconds
GET /training/paths/v120060 seconds
GET /training/paths/v1/{path ID}20060 seconds
GET /training/individualleaderboards/v120060 seconds
GET /training/individualleaderboards/v1/rankings20060 seconds
GET /training/rapid-refresh/v120060 seconds
GET /training/rapid-refresh/v1/{id}20060 seconds
Other80060 seconds

Rate limit response headers

All responses sent from the API will include headers which can be used to help manage the rate which requests are being sent to the API.

HeaderDescription
x-ratelimit-limitThe rate limit credit for that given endpoint
x-ratelimit-remainingThe number of requests left for the window
x-ratelimit-resetThe number of seconds until this window resets