Introdução
Rate Limit is the maximum number of requests that a single application can make in a given period of time. When the application exceeds this limit, the API request will fail and return an HTTP 429 status code.These limits help us to provide the API that is reliable and scalable.In case of 429 error, review the behavior of your application
In many cases, an application can be blocked when it enters some looping state due to a crash or unexpected behavior.If you get this error, check if the application should really be making so many requests to this endpoint.In this article, you will find some recommendations and good practices for using our APIs.
Modules
Each module/endpoint can have a specific rate limit policy:Authentication
| Endpoint | Limit |
|---|---|
| POST /oauth/token | 20 req/min |
| POST /oauth/userCode | 20 req/min |
Order
| Endpoint | Limit |
|---|---|
| GET /events:polling | 6000 req/min |
| POST /events/acknowledgment | 6000 req/min |
| GET /orders/{id} | 3000 req/min |
| GET /orders/{id}/virtual-bag | 1000 req/s |
| POST /orders/{id}/confirm | 3000 req/min |
| POST /orders/{id}/startPreparation | 3000 req/min |
| POST /orders/{id}/readyToPickup | 3000 req/min |
| POST /orders/{id}/dispatch | 3000 req/min |
| POST /orders/{id}/requestCancellation | 300 req/min |
| POST /orders/{id}/requestDriver | 120 req/min |
| POST /orders/{id}/tracking | 5000 req/min |
| POST /order/v1.0/disputes/{disputeId}/accept | 1000 req/min |
| POST /order/v1.0/disputes/{disputeId}/reject | 1000 req/min |
| POST /order/v1.0/disputes/{disputeId}/alternatives/{alternativeId} | 1000 req/min |
Shipping
| Endpoint | Limite |
|---|---|
| GET /merchants/{merchantId}/deliveryAvailabilities | 4000 req/min |
| GET /orders/{orderId}/deliveryAvailabilities | 4000 req/min |
| POST /merchants/{merchantId}/order | 4000 req/min |
| POST /orders/{orderId}/requestDriver | 4000 req/min |
| POST /orders/{orderId}/cancel | 600 req/min |
| POST /orders/{orderId}/cancelRequestDriver | 600 req/min |
| POST /orders/{orderId}/userConfirmAddress | 500 req/min |
| POST /orders/{orderId}/deliveryAddressChangeRequest | 500 req/min |
| POST /orders/{orderId}/acceptDeliveryAddressChange | 500 req/min |
| POST /orders/{orderId}/denyDeliveryAddressChange | 500 req/min |
| GET /orders/{orderId}/safeDelivery | 500 req/min |
Merchant
| Endpoint | Limit |
|---|---|
| GET /merchants | 100 req/min |
| GET /merchants/{merchantId} | 300 req/min |
| GET /merchants/{merchantId}/status | 20000 req/min |
| GET /merchants/{merchantId}/interruptions | 100 req/min |
| POST /merchants/{merchantId}/interruptions | 200 req/min |
| DELETE /merchants/{merchantId}/interruptions/{interruptionId} | 100 req/min |
| GET /merchants/{merchantId}/opening-hours | 100 req/min |
| PUT /merchants/{merchantId}/opening-hours | 200 req/min |
Reviews
| Endpoint | Limit |
|---|---|
| GET /merchants/{merchantId}/reviews | 2000 req/min |
| GET /merchants/{merchantId}/reviews/{reviewId} | 2000 req/min |
| POST /merchants/{merchantId}/reviews/{reviewId}/answers | 2000 req/min |
| GET /merchants/{merchantId}/summary | 2000 req/min |
Financial
| Endpoint | Limit |
|---|---|
| GET /merchants/{merchantId}/sales | 1000 req/min |
| GET /merchants/{merchantId}/payments | 1000 req/min |
| GET /merchants/{merchantId}/paymentDetails | 1000 req/min |
| GET /merchants/{merchantId}/occurrences | 1000 req/min |
| GET /merchants/{merchantId}/maintenanceFees | 1000 req/min |
| GET /merchants/{merchantId}/incomeTaxes | 1000 req/min |
| GET /merchants/{merchantId}/periods?competence={competence} | 1000 req/min |
| GET /merchants/{merchantId}/chargeCancellations | 1000 req/min |
| GET /merchants/{merchantId}/cancellations | 1000 req/min |
| GET /merchants/{merchantId}/receivableRecords | 1000 req/min |
Catalog v1
| Endpoint | Limite |
|---|---|
| All Catalog Endpoints | 15000 req/min |
Catalog v2
| Endpoint | Limite |
|---|---|
| GET /merchants/{merchantId}/catalogs/{catalogId}/categories | 3000 req/min |
| POST /merchants/{merchantId}/catalogs/{catalogId}/categories | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{catalogId}/categories/{categoryId} | 3000 req/min |
| PATCH /merchants/{merchantId}/catalogs/{catalogId}/categories/{categoryId} | 3000 req/min |
| GET /merchants/{merchantId}/categories/{categoryId}/items | 3000 req/min |
| DELETE /merchants/{merchantId}/categories/{categoryId} | 3000 req/min |
| GET /merchants/{merchantId}/catalogs | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{catalogId}/unsellableItems | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{groupId}/sellableItems | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{catalogId}/changelog | 3000 req/min |
| GET /merchants/{merchantId}/catalog/version | 3000 req/min |
| GET /merchants/{merchantId}/products | 3000 req/min |
| POST /merchants/{merchantId}/products | 3000 req/min |
| PUT /merchants/{merchantId}/products/{productId} | 3000 req/min |
| DELETE /merchants/{merchantId}/products/{productId} | 3000 req/min |
| PATCH /merchants/{merchantId}/products/status | 5000 req/min |
| PATCH /merchants/{merchantId}/products/price | 5000 req/min |
| GET /merchants/{merchantId}/product/{productId} | 3000 req/min |
| GET /merchants/{merchantId}/products/externalCode/{externalCode} | 3000 req/min |
| DELETE /merchants/{merchantId}/categories/{categoryId}/products/{productId} | 3000 req/min |
| GET /merchants/{merchantId}/items/{itemId}/flat | 3000 req/min |
| PATCH /merchants/{merchantId}/item/price | 5000 req/min |
| PATCH /merchants/{merchantId}/item/status | 5000 req/min |
| PATCH /merchants/{merchantId}/item/externalCode | 3000 req/min |
| PUT /merchants/{merchantId}/items | 3000 req/min |
| GET /merchants/{merchantId}/optionGroups | 5000 req/min |
| DELETE /merchants/{merchantId}/optionGroups/{optionGroupId} | 3000 req/min |
| PATCH /merchants/{merchantId}/optionGroups/{optionGroupId} | 5000 req/min |
| DELETE /merchants/{merchantId}/optionGroups/{optionGroupId}/products/{productId} | 5000 req/min |
| PATCH /merchants/{merchantId}/optionGroups/{optionGroupId}/status | 5000 req/min |
| DELETE /merchants/{merchantId}/optionGroups/{optionGroupId}/products/{productId}/option | 5000 req/min |
| PATCH /merchants/{merchantId}/options/price | 5000 req/min |
| PATCH /merchants/{merchantId}/options/status | 5000 req/min |
| PATCH /merchants/{merchantId}/options/externalCode | 5000 req/min |
| GET /merchants/{merchantId}/batch/{batchId} | 5000 req/min |
| POST /merchants/{merchantId}/inventory | 5000 req/min |
| GET /merchants/{merchantId}/inventory/{productId} | 5000 req/min |
| POST /merchants/{merchantId}/inventory/batchDelete | 5000 req/min |
| POST /merchants/{merchantId}/version/upgrade | 3000 req/min |
| POST /merchants/{merchantId}/version/downgrade | 3000 req/min |
Logistics
| Endpoint | Limite |
|---|---|
| POST /logistics/v1.0/orders/{id}/assignDriver | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/goingToOrigin | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/arrivedAtOrigin | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/dispatch | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/arrivedAtDestination | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/verifyDeliveryCode | 3000 req/min |
Picking
| Endpoint | Limit |
|---|---|
| POST /orders/{id}/startSeparation | 1000 req/s |
| POST /orders/{id}/endSeparation | 1000 req/s |
| POST /orders/{id}/items | 1000 req/s |
| PATCH /orders/{id}/items/{uniqueId} | 1000 req/s |
| DELETE /orders/{id}/items/{uniqueId} | 1000 req/s |