Overview of Rate Limiting
Walmart sets rate limits for each Partner API. In this article we detail the rate limits that have been set, how to understand your usage, and what will occur if you exceed the rate limits.
What to expect if you exceed rate limits
If you try to exceed the limits, your API calls will be returned with an error: 429, “Too Many Requests.”
How to Understand Current Usage – API Response Headers
When you use our API’s, we will return your current usage in response headers. Use the following response headers
| Name | Description |
| X-Current-Token-Count | Current token count i.e. the number of requests that will be allowed in current window. |
| X-Next-Replenishment-Time | Time at which current window ends and throttling count is reset. |
API Call Allotment Replenishment
The hourly and daily ASYNC and SYNC API calls are throttled. However, the limits are replenished gradually. For hourly limits, the allotment increases every few mins so the full hourly limits are available after the hour. Daily limits are similarly replenished every few hours.
For example, if 20 calls are available every Hour, 1 call will be available every 3 minutes after all the calls are already consumed. It is recommended to use the header values to have access to higher API call allotments.