Rate limiting
API rate limiting is a crucial mechanism used to control the number of API requests a seller can make in a given time period. This ensures the stability and reliability of the API service by preventing abuse and overuse.
Benefits
API rate limiting provides multiple advantages that enhance overall service efficiency and security.
- Enhanced performance: By limiting the number of requests, APIs can maintain optimal performance levels, ensuring that all users experience consistent and reliable service.
- Fair usage: Rate limits ensure that resources are distributed fairly among all users, preventing any single user from monopolizing the service.
- Protection against abuse: Rate limiting helps protect the API from malicious attacks such as Denial of Service (DoS), where an attacker overwhelms the service with excessive requests.
- Improved security: It acts as a layer of security by reducing the risk of automated scraping and other unauthorized activities.
By implementing API rate limiting, Walmart aims to offer a more secure, stable, and fair service to all users, enhancing the overall user experience.
API usage limits (Rate limits and throttling)
Walmart imposes limits on its API usage to ensure fair resource usage and protect platform stability. All Walmart API users are responsible for ensuring their API usage remains within these limits.
The API usage is restricted in two ways:
Rate limits
- Definition: Limits the number of API requests allowed within a particular timeframe.
- Variability: Rate limits vary by API.
- Consequences: If rate limits are exceeded, then you will be throttled, receiving a
429 – Too Many Requestserror code response.
Max file size limits
- Definition: Limits the file size allowed for different API feed types.
- Variability: File size limits vary by feed type.
- Consequences: If file size limits are exceeded, then your request will be denied, receiving a
413 – Payload Too Largeerror code response.
Algorithm for rate limits
Walmart utilizes a token bucket algorithm to enforce rate limits. Imagine a bucket that holds a fixed number of tokens, each representing an API call. When there are tokens in the bucket, an API request is allowed, and a token is removed from the bucket. If there are no tokens left, the API request is denied. The bucket is continuously replenished with tokens at a fixed rate. For example, if the rate limit is 20 requests per hour, the limit may replenish one request every 3 minutes.
Finding your usage limits
- Usage limits are posted on the Walmart Developer portal for your convenience.
- When you call Walmart APIs, the response header includes two parameters indicating your current rate limit for the specific API you are calling.
| Parameter | Description |
|---|---|
| x-current-token-count | Your current number of tokens available, which is your request limit for this API. |
| X-Next-Replenishment-Time | The next time at which your token count increases, allowing additional requests for this API. |
API rate limits
The following table provides the default API call limit rates for individuals and smaller businesses.
| API category | API name / Endpoint | US rate limit | CA rate limit | MX rate limit | CL rate limit | Method |
|---|---|---|---|---|---|---|
| Assortment Recommendations | Get Recommendations /v3/growth/assortment/recommendations | 500/min | 10/min | 50/hour | NA | POST |
| Get Variants /v3/growth/assortment/recommendations/variants | 500/hour | NA | NA | NA | GET | |
| Get Recommendation Trends /v3/growth/assortment/recommendations/trends | 500/hour | NA | NA | NA | GET | |
| Get Categorization /v3/growth/assortment/recommendations/categorization/counts | 200/hour | 200/hour | 300/hour | NA | POST | |
| Reject Recommendations /v3/growth/assortment/recommendations/rejections | 20/hour | 50/hour | 50/hour | NA | PUT | |
| Disputes Management | Dispute status /v3/items/dispute/duplicates/status | 10/min | NA | NA | NA | POST |
| Dispute submission /v3/items/dispute/duplicates/contest | 10/min | NA | NA | NA | POST | |
| Feed Management | All feed statuses /v3/feeds | 5000/min (Shared with Feed item status) | 5000/min (Shared with Feed item status) | 5000/min (Shared with Feed item status) | 5000/min (Shared with Feed item status) | GET |
| Feed item status /v3/feeds/{feedId} | 5000/min (Shared with All feed statuses) | 5000/min (Shared with All feed statuses) | 5000/min (Shared with All feed statuses) | 5000/min (Shared with All feed statuses) | GET | |
| Get feed error report /v3/feeds/{feedId}/errorReport | 60/hour | NA | NA | NA | GET | |
| Fulfillment Management (WFS) | Update Shipment Quantities /v3/fulfillment/shipment-quantities | PUT | ||||
| Hazmat Items On Hold /v3/items/onhold/search | 30/hour | NA | NA | NA | POST | |
| Update Shipment Tracking /v3/fulfillment/shipment-tracking | 2/min | 50/min | 50/min | NA | POST | |
| Create Inbound Shipment label /v3/fulfillment/shipment-label | 20/min | 500/min | 500/min | NA | POST | |
| Get Shipments /v3/fulfillment/inbound-shipments | 32/min | 50/min | 50/min | NA | GET | |
| Create Inbound Shipment /v3/fulfillment/inbound-shipments | 500/min | 50/min | 50/min | NA | POST | |
| Fetch Inbound Preview /v3/fulfillment/inbound-preview | 60/hour | NA | NA | NA | POST | |
| Get Carrier Rate Quote /v3/fulfillment/carrier-rate-quotes/{shipmentId}/{mode} | 150/min | 50/min | NA | NA | GET | |
| Create Carrier Rate Quote /v3/fulfillment/carrier-rate-quotes | 8/min | 50/min | NA | NA | POST | |
| Confirm Carrier Rate Quote /v3/fulfillment/carrier-rate-quote/confirm | 8/min | 50/min | NA | NA | POST | |
| Print Carrier Label /v3/fulfillment/carrier-label/{shipmentId} | 30/min | 50/min | NA | NA | POST | |
| Get WFS Inventory Health Report /v3/report/wfs/getInventoryHealthReport | 5/min | 50/min | 50/min | NA | GET | |
| Get WFS Inventory Reconciliation Report /v3/report/wfs/inventoryReconciliationReport | 1/hour | NA | NA | NA | GET | |
| Get Inventory Log for a WFS item /v3/fulfillment/inventory-log | 500/min | 50/min | 50/min | NA | GET | |
| Get Inbound Shipment Items /v3/fulfillment/inbound-shipment-items | 300/min | 50/min | 50/min | NA | GET | |
| Get Inbound Shipment errors /v3/fulfillment/inbound-shipment-errors | 10/min | 50/min | 50/min | NA | GET | |
| Cancel Inbound Shipment /v3/fulfillment/inbound-shipments/{inboundOrderId} | 10/min | 50/min | 50/min | NA | DELETE | |
| Cancel Carrier Rate Quote /v3/fulfillment/carrier-rate-quote | DELETE | |||||
| Create Inbound Shipment label (Deprecated) /v3/fulfillment/label/{shipmentId} | GET | |||||
| Create Carrier Rate Quote /v4/fulfillment/inbound-shipments-quote | 10/min | NA | NA | NA | POST | |
| Get Carrier Rate Quote /v4/fulfillment/inbound-shipments- quote/{quoteType}/{shipmentId} | 150/min | NA | NA | NA | GET | |
| Create Booking /v4/fulfillment/inbound-shipments-booking | 8/min | NA | NA | NA | POST | |
| Get Booking /v3/fulfillment/inbound-shipments-booking | GET | |||||
| Print Bill of Lading (BOL) /v4/fulfillment/inbound-shipments-bol/{shipmentId}/{mode} | 10/min | NA | NA | NA | GET | |
| Generate Label /v4/fulfillment/generate-label | 20/min | NA | NA | NA | POST | |
| Download Label /v4/fulfillment/download-label/{shipmentId}/{labelType}/{labelSize} | 300/min | NA | NA | NA | GET | |
| Cancel Booking /v4/fulfillment/inbound-shipments-booking/{shipmentId}/{mode} | 10/min | NA | NA | NA | DELETE | |
| Get Pickup Seller Schedule /v3/fulfillment/inbound-seller-schedule | GET | |||||
| Get Shipment Tracking /v3/fulfillment/inbound-shipments-tracking | GET | |||||
| Update Pickup Scheduling /v3/fulfillment/inbound-schedule-update | POST | |||||
| Create Customer Order /v3/fulfillment/orders-fulfillments | POST | |||||
| Fetch Delivery Promise Details /v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptions | 20/min | NA | NA | NA | POST | |
| Cancel Customer Order /v3/fulfillment/orders-fulfillments/cancel | 600/min | NA | NA | NA | POST | |
| Get fulfillment orders status /v3/fulfillment/orders-fulfillments/status | 20/min | NA | NA | NA | GET | |
| Create Customer Return Order /v3/fulfillment/return-orders | POST | |||||
| Get Customer Return Orders status /v3/fulfillment/return-orders | GET | |||||
| Cancel Customer Return Order /v3/fulfillment/return-orders/{orderId}/cancel | POST | |||||
| Create MCS sales channel details /v3/fulfillment/orders-fulfillments/channel-details | POST | |||||
| Get MCS sales channel details /v3/fulfillment/orders-fulfillments/channel-details | GET | |||||
| Update MCS sales channel details /v3/fulfillment/orders-fulfillments/channel-details | PUT | |||||
| Insights Management | Item Listing Quality Details /v3/insights/items/listingQuality/items | 1/min | 60/min | 2/min | NA | POST |
| Item count with listing quality issues /v3/insights/items/listingQuality/count | GET | |||||
| Seller Listing Quality Score /v3/insights/items/listingQuality/score | 10/hour | 60/min | 15/min | NA | GET | |
| Pro Seller Tier and Rewards Status /v3/insights/sellerIncentives | 1/min | 1/min | NA | NA | GET | |
| Pro Seller Badge Status /v3/insights/prosellerbadge | 1/min | NA | NA | 1/min | GET | |
| Unpublished Items /v3/insights/items/unpublished/items | 100/min | 100/min | 100/min | NA | GET | |
| Unpublished Item Counts /v3/insights/items/unpublished/counts | 100/min | 100/min | 100/min | NA | GET | |
| Inventory Management | Inventory (legacy) /v3/inventory | 200/min | 200/min | 200/min | 200/min | GET |
| Update Inventory /v3/inventory | 200/min | 200/min | 200/min | 200/min | PUT | |
| Single Item Inventory by Ship Node /v3/inventories/{sku} | 200/min | 200/min | 200/min | 200/min | GET | |
| Update Item Inventory per Ship Node /v3/inventories/{sku} | 200/min | 200/min | 200/min | 200/min | PUT | |
| Multiple Item Inventory for All Ship Nodes /v3/inventories | 200/min | NA | NA | NA | GET | |
| WFS Inventory /v3/fulfillment/inventory | GET | |||||
| Item Management | Get Spec /v3/items/spec | 10/min | NA | NA | NA | POST |
| Catalog Search /v3/items/catalog/search | 200/min (Shared with Get Item Associations) | 200/min | 200/min | 200/min | POST | |
| Get Item Associations /v3/items/associations | 200/min (Shared with Catalog Search) | 200/min | 200/min | NA | POST | |
| All items /v3/items | 300/min (if used with query parameters 60/min) | 300/min | 300/min | 300/min | GET | |
| An item /v3/items/{id} | 900/min (if used with query parameters 60/min) | 900/min | 900/min | 900/mim | GET | |
| Item Search /v3/items/walmart/search | 200/min 1000/day (if used with specFormat=SPEC | NA | NA | NA | GET | |
| Taxonomy /v3/items/taxonomy | 200/min (Shared with Get items count by status) | 200/min | 200/min | NA | GET | |
| Get item count by groups /v3/items/groups/count | 100/min | 100/min | 100/min | 100/min | GET | |
| Get items count by status /v3/items/count | 200/min (Shared with Taxonomy) | 200/min | 200/min | 200/min | GET | |
| Retire an item /v3/items/{sku} | 900/min | 900/min | 900/min | 900/min | DELETE | |
| Lag Time | Lag Time /v3/lagtime | 20/hour | 200/min | 200/min | 200/min | GET |
| Notifications Management | Test Notification /v3/webhooks/test | 10/min | NA | NA | NA | POST |
| All Subscriptions /v3/webhooks/subscriptions | 50/min | NA | NA | NA | GET | |
| Create Subscription /v3/webhooks/subscriptions | 200/min | NA | NA | NA | POST | |
| Delete Subscription /v3/webhooks/subscriptions/{subscriptionId} | 10/min | NA | NA | NA | DELETE | |
| Update Subscription /v3/webhooks/subscriptions/{subscriptionId} | 5/min | NA | NA | NA | PATCH | |
| Event Types /v3/webhooks/eventTypes | 5/min | NA | NA | NA | GET | |
| On-Request Report Management | Get All Report Requests /v3/reports/reportRequests | 200/min | 200/min | 200/min | 200/min | GET |
| Create Report Schedule /v3/reports/schedules | 60/min | NA | NA | NA | POST | |
| Report Request Status /v3/reports/reportRequests/{requestId} | 20/hour | 20/hour | 20/hour | 20/hour | GET | |
| Download Report URL /v3/reports/downloadReport | 20/hour | 20/hour | 20/hour | 20/hour | GET | |
| Order Management | Ship Order Lines /v3/orders/{purchaseOrderId}/shipping | 60/min | 60/min | 60/min | 60/min | POST |
| Multi-package shipping updates /v3/orders/{purchaseOrderId}/multiPackageShipping | POST | |||||
| Refund Order Lines /v3/orders/{purchaseOrderId}/refund | 60/min | 60/min | 60/min | 60/min | POST | |
| Cancel Order Lines /v3/orders/{purchaseOrderId}/cancel | 60/min | 60/min | 60/min | 60/min | POST | |
| Acknowledge Orders /v3/orders/{purchaseOrderId}/acknowledge | 60/min | 60/min | 60/min | 60/min | POST | |
| All orders /v3/orders | 5000/min | 60/min | 60/min | 60/min | GET | |
| Get an order /v3/orders/{purchaseOrderId} | 5000/min | 60/min | 60/min | 60/min | GET | |
| All released orders /v3/orders/released | 60/min | 60/min | NA | NA | GET | |
| All wfs orders /v3/orders/wfs | GET | |||||
| Delivery Updates /v3/orders/{purchaseOrderId}/deliver | POST | |||||
| Get Shipping Label /v3/orders/label/{trackingNumber} | GET | |||||
| Download Bulk Shipping Label /v3/orders/labels | POST | |||||
| Price Management | Update Repricer Strategy /v3/repricer/strategy/{strategyCollectionId} | 10/hour | 120/hour | 120/hour | NA | PUT |
| Delete Repricer Strategy /v3/repricer/strategy/{strategyCollectionId} | 10/hour | 120/hour | 120/hour | NA | DELETE | |
| Create Repricer Strategy /v3/repricer/strategy | 20/hour | 20/hour | 20/hour | NA | POST | |
| List of Repricer Strategies /v3/repricer/strategies | 50/hour | 120/hour | 120/hour | NA | GET | |
| List of Price Incentive Items /v3/price/incentives | 60/min | NA | NA | NA | GET | |
| Update the enrollment status of Walmart-funded incentive items /v3/price/incentives/wfpreference | 1/min | NA | NA | NA | PUT | |
| Update Walmart-funded incentives enrollment /v3/feeds?feedType=WALMART_FUNDED_INCENTIVES_ENROLLMENT | POST | |||||
| Update reduced referral fee incentives enrollment /v3/feeds?feedType=INCENTIVE_ENROLLMENT | POST | |||||
| Update bulk prices Multiple /v3/feeds?feedType=PRICE_AND_PROMOTION | 10/hour | 30/day | 30/day | 30/day | POST | |
| Assign/Unassign items to/from Repricer Strategy /v3/repricerFeeds | 6/hour | 6/hour | 6/hour | NA | POST | |
| Update pricing for a single item /v3/price | 100/hour | NA | 30/min | 5/min | PUT | |
| Promotion Management | Update a promotional price /v3/price | 100/hour | NA | 60/min | 100/min | PUT |
| Promotional prices /v3/promo/sku/{sku} | 1000/min | 60/min | 50/min | 60/min | GET | |
| Returns Management | Refund Order Lines /v3/returns/{returnOrderId}/refund | 60/min | NA | 60/min | NA | POST |
| Get Returns /v3/returns | 50/min | NA | 60/min (Both Get Returns and Get Returns With Cursor) | NA | GET | |
| Get all returns with cursor mark /v3/returns/cursor | GET | |||||
| Recommendations | Recommended Shipment Quantity /v3/wfs/recommendation/shipment-quantity | 100/min | NA | NA | NA | GET |
| Reviews Acceleration | Bulk Update Item Status /v3/growth/reviews-accelerator/items/status | 100/hour | NA | NA | NA | PUT |
| Get RAP Post-Purchase Items /v3/growth/reviews-accelerator/items | 20/min | NA | NA | NA | POST | |
| Get Categories /v3/growth/reviews-accelerator/categories | 100/hour | NA | NA | NA | POST | |
| Settings Management | Get Shipping Template Details /v3/settings/shipping/templates/{templateId} | 750/min | 100/min | 100/min | NA | GET |
| Update Shipping Templates /v3/settings/shipping/templates/{templateId} | 100/min | 100/min | 100/min | NA | PUT | |
| Delete Shipping Template /v3/settings/shipping/templates/{templateId} | 100/min | 100/min | 100/min | NA | DELETE | |
| Get all fulfillment centers /v3/settings/shipping/shipnodes | 50/min | 100/min | 100/min | NA | GET | |
| Update fulfillment center /v3/settings/shipping/shipnodes | 60/min | 100/min | 100/min | NA | PUT | |
| Create fulfillment center /v3/settings/shipping/shipnodes | 10/min | 100/min | 100/min | NA | POST | |
| Get account level settings /v3/settings/shipping/account | 50/min | 100/min | 100/min | NA | GET | |
| Update account level settings /v3/settings/shipping/account | 100/min | 100/min | 100/min | NA | PUT | |
| Create account level settings /v3/settings/shipping/account | 10/min | 100/min | 100/min | NA | POST | |
| Get All Shipping Templates /v3/settings/shipping/templates | 300/min | 100/min | 100/min | NA | GET | |
| Create Shipping Templates /v3/settings/shipping/templates | 60/min | 100/min | 100/min | NA | POST | |
| Third party fulfillment center association /v3/settings/shipping/3plshipnodes | 10/min | NA | NA | NA | POST | |
| Get Shipping Configurations /v3/settings/shippingprofile | 100/min | NA | NA | NA | GET | |
| Get Shipping Template Activation Status /v3/settings/shipping/templates/activationStatus | 10/min | NA | NA | NA | GET | |
| Get coverage for fulfillment centers /v3/settings/shipping/shipnodes/coverage | 100/min | NA | NA | NA | GET | |
| Get carrier methods /v3/settings/shipping/carriers | 10/min | NA | NA | NA | GET | |
| Get all third party fulfillment providers /v3/settings/shipping/3plproviders | 10/min | NA | NA | NA | GET | |
| Get Partner Configurations /v3/settings/partnerprofile | 50/min | NA | NA | NA | GET | |
| Ship With Walmart | Create label /v3/shipping/labels | 100/min | 200/min | 200/min | 200/min | POST |
| Shipping estimates /v3/shipping/labels/shipping-estimates | 100/min | 200/min | 200/min | 200/min | POST | |
| Labels detail by purchase order id /v3/shipping/labels/purchase-orders/{purchaseOrderId} | 100/min | 200/min | 200/min | 200/min | GET | |
| Supported carriers /v3/shipping/labels/carriers | 100/min | 200/min | 200/min | 200/min | GET | |
| Download label /v3/shipping/labels/carriers/{carrierShortName}/trackings/{trackingNo} | 100/min | 200/min | 200/min | 200/min | GET | |
| Discard label /v3/shipping/labels/carriers/{carrierShortName}/trackings/{trackingNo} | 100/min | 200/min | 200/min | 200/min | DELETE | |
| Supported carrier package types /v3/shipping/labels/carriers/{carrierShortName}/package-types | 100/min | 200/min | 200/min | 200/min | GET | |
| Simplified Shipping Settings Management | Update FC Level Simplified Shipping Settings /v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter | 25/min | NA | NA | NA | PUT |
| Update Simplified Shipping Settings /v3/settings/shipping/simplifiedshippingsettings/account | 25/min | NA | NA | NA | PUT | |
| Create Simplified Shipping Settings /v3/settings/shipping/simplifiedshippingsettings/account | 5/min | NA | NA | NA | POST | |
| Get Simplified Shipping Settings /v3/settings/shipping/simplifiedshippingsettings | 50/min | NA | NA | NA | GET | |
| Utilities Management | Taxonomy by Spec /v3/utilities/taxonomy | 20/min | NA | NA | NA | GET |
| API Platform Status /v3/utilities/apiStatus | 100/min | NA | NA | NA | GET |
Feed type usage limits
| Feed type | US Maximum file size | US Rate limit | CA Maximum file size | CA Rate limit | MX Maximum file size | MX Rate limit | CL Maximum file size | CL Rate limit |
|---|---|---|---|---|---|---|---|---|
| inventory | 10 MB | 10/hour | 10 MB | 10/hour | 10 MB | 10/hour | 10 MB | 10/hour |
| mp_item_price_update | 25 MB | 20/hour | ||||||
| sku_template_map | 10 MB | 10/hour | 10 MB | 20/hour | 10 MB | 20/hour | NA | NA |
| dsv_inventory | 10 MB | 50/hour | NA | NA | NA | NA | NA | NA |
| mp_inventory | 1 MB | 50/hour | 1 MB | 20/hour | 1 MB | 50/hour | NA | NA |
| mp_item | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| mp_maintenance | 25 MB | 10/hour | NA | 10/hour | 25 MB | 10/hour | NA | NA |
| delete_item | 0.4 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| lagtime | 10 MB | 6/hour | 10 MB | 6/hour | NA | NA | 10 MB | 6/hour |
| price | 10 MB | 6/day | NA | NA | NA | NA | NA | NA |
| PRICE_AND_PROMOTION | NA | 10/hour | NA | 30/day | NA | 30/day | NA | 30/day |
| promo | 10 MB | 6/day | NA | NA | NA | NA | NA | NA |
| mp_item_match | 25 MB | 20/hour | 25 MB | 10/hour | 25 MB | 10/hour | 25 MB | 10/hour |
| INCENTIVE_ENROLLMENT | NA | 6/day | NA | 6/day | NA | 6/day | NA | 6/day |
| omni_dsv_item | 25 MB | 20/hour | NA | NA | NA | NA | NA | NA |
| omni_maintenance | 25 MB | 20/hour | NA | NA | NA | NA | NA | NA |
| item | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| shipping_overrides | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| mp_wfs_item | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| omni_wfs | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| program_actions | 25 MB | 20/hour | NA | NA | NA | NA | NA | NA |
| mp_wfs_maintenance | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| split_and_merge | 25 MB | 10/hour | NA | NA | NA | NA | NA | NA |
| omni_wfssetup | NA | NA | 25 MB | 10/hour | 25 MB | 10/hour | NA | NA |
| omni_wfsconvert | NA | NA | 25 MB | 10/hour | 25 MB | 10/hour | NA | NA |
| mp_item_intl | NA | NA | 25 MB | 10/hour | 25 MB | 10/hour | 25 MB | 10/hour |
Updated 9 days ago