KFirst steps
Homologation
About our APIs
Overview
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 status code 429 (Too Many Requests).These limits help us provide a reliable and scalable API for all users.How they work
Each module and endpoint of the iFood API has specific request limit policies. Limits vary based on:- The specific endpoint being accessed.
- The type of your application.
- Time window (per minute, hour, or day).
Handling 429 errors
If you receive a 429 error:- Review your application's behavior.
- Check if there's code that might be in a loop.
- Implement exponential backoff and retry logic.
- Consider caching responses when appropriate.
429 Errors
Many 429 errors occur when applications enter a loop state due to unexpected failures. Check if your application really needs to make frequent requests to the affected endpoint.
Best practices
- Implement request rate monitoring in your application.
- Add specific error handling for 429 responses.
- Use our response headers to track your current usage:
X-RateLimit-Limit: Your total request allocation.X-RateLimit-Remaining: Remaining requests in the current window.X-RateLimit-Reset: Time (in seconds) until your limit is reset.
Best practices
Check the documentation about Best practices.
Specific limits by module
Check below the specific request limits that apply to each module.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}/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 | Limit |
|---|---|
| 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 | 100 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 |
| GET /merchants/{merchantId}/salesAdjustments | 1000 req/min |
| GET /merchants/{merchantId}/salesBenefits | 1000 req/min |
| GET /merchants/{merchantId}/adjustmentsBenefits | 1000 req/min |
Catalog v1
| Endpoint | Limit |
|---|---|
| All Catalog module endpoints | 15000 req/min |
Catalog v2
| Endpoint | Limit |
|---|---|
| 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 |
Promotion
| Endpoint | Limit |
|---|---|
| POST /merchants/{merchantId}/promotions | 1000 req/min |
Item
| Endpoint | Limit |
|---|---|
| POST /ingestion/{merchantId} | 1000 req/min |
| PATCH /ingestion/{merchantId} | 1000 req/min |
Logistics
| Endpoint | Limit |
|---|---|
| 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 |
Was this page helpful?
Rate your experience in the new Developer portal: