Rate limits
API Rate Limits
To ensure fair usage and maintain performance for all users, certain API endpoints are subject to rate limits. These limits restrict the number of requests that can be made to specific endpoints within a defined time period. Exceeding the rate limit will result in a 429 Too Many Requests error response.
Understanding Rate Limits
Each rate-limited endpoint has a defined threshold measured in requests per minute. If your application exceeds this threshold, further requests will be temporarily blocked until the limit resets.
To avoid exceeding rate limits:
- Implement retry logic with exponential backoff.
- Monitor your usage patterns and adjust your requests accordingly.
- Cache catalog data (
/products,/products/status) — it changes rarely. - Use Webhooks instead of polling for order status updates. Endpoints
GET /orders/{id}andGET /orders/{id}/statushave strict per-ID limits (3–5 req/min) because real-time status updates are delivered via webhooks.
Webhooks instead of polling
Don't poll GET /orders/{id}/status repeatedly — configure a Webhook URL in the Partner Panel to receive ORDER_STATUS_CHANGED events automatically when an order moves to PENDING, ACTIVE, REFUNDED, or other statuses.
Rate-Limited Endpoints
Below is a table of API endpoints with their respective rate limits. All time windows are per minute.
| Endpoint | Standard Limits | Premium Limits | Enterprise Limits | Time Window |
|---|---|---|---|---|
GET /products | 5 requests | 20 requests | 60 requests | Per minute |
GET /products/status | 5 requests | 20 requests | 60 requests | Per minute |
GET /users | 20 requests | 100 requests | 200 requests | Per minute |
GET /users/{id}/orders | 10 requests | 40 requests | 200 requests | Per minute for the same {id} |
POST /orders | 10 requests | 50 requests | 200 requests | Per minute |
GET /orders | 20 requests | 100 requests | 200 requests | Per minute |
GET /orders/{id} | 5 requests | 5 requests | 10 requests | Per minute for the same {id} |
GET /orders/{id}/status | 3 requests | 3 requests | 10 requests | Per minute for the same {id} |
POST /orders/{id}/cancel-pending | 5 requests | 20 requests | 50 requests | Per minute for the same {id} |
POST /orders/{id}/cancel-deferred | 5 requests | 20 requests | 50 requests | Per minute for the same {id} |
POST /validate-vehicle | 50 requests | 200 requests | 500 requests | Per minute |