Request Rate Limits

Overview

  • Rate limits are per minute per store, unless otherwise stated here.

  • General rate limit is 2000 rpm (requests per minute). This quota is shared between all endpoints, except specificaly stated here.

  • When the rate limit is reached, the corresponding endpoints will return error response with HTTP status code 429 (Too Many Requests) until the end of the period.

Endpoints with Custom Limits

Endpoints returning multiple objects at once produce more pressure on Joom’s servers and require to be called less frequently, that’s why they have the shared rate limit of 50 rpm.

Endpoints with lower limit
GET products/multi
GET orders/unfulfilled
GET orders/multi

Response Headers

Each API response contains the following headers showing current rate limit status.

Header Name Description
X-Rate-Limit-Limit The allowed number of requests per minute.
X-Rate-Limit-Reset The number of seconds left till the end of the current rate limit window.
X-Rate-Limit-Remaining The number of requests remaining in the current rate limit window. 0 when the limit has been reached.