Update: Throttling changes for the Merchant Fulfillment API
Amazon has raised the throttling limits for Merchant Fulfillment API v0: getEligibleShippingServices now allows 6 steady‑state calls per second (up from 5) and a burst of 12 (up from 10); createShipment now permits 5 steady calls per second (up from 4) with a burst of 10 (up from 8). The change aims to cut 429 errors for high‑volume fulfillment scripts.
Overview
Amazon has increased the throttling limits for two primary Merchant Fulfillment API v0 endpoints—getEligibleShippingServices and createShipment. The steady‑state allowance for getEligibleShippingServices has moved from 5 to 6 calls per second, while its burst ceiling grew from 10 to 12 calls. CreateShipment now permits 5 steady calls per second (up from 4) and a burst maximum of 10 calls (up from 8). Sellers who automate large volumes of order fulfillment need to understand these new thresholds to keep their shipping pipelines running without unexpected 429 errors.
Key Points
- Higher steady‑state quota — getEligibleShippingServices can now be invoked up to 6 times each second, giving a modest but useful margin during continuous traffic.
- Expanded burst window — The same endpoint can absorb short‑term spikes of up to 12 calls in a single second, compared with the former limit of 10.
- CreateShipment uplift — CreateShipment’s baseline rate rose to 5 calls per second, and its burst capacity increased to 10 calls, enabling quicker batch shipment creation.
- 429 responses still apply — If a caller exceeds the revised limits, the API will return an HTTP 429 status, so ongoing monitoring remains mandatory.
- Third‑party tools benefit — Order‑management platforms that bundle dozens of shipments per minute will experience fewer “Too Many Requests” interruptions.
- No version migration needed — The changes affect the existing v0 endpoints; developers do not need to switch to a new API version.
How the Throttling Changes Work
- Quota verification — Every inbound request to either getEligibleShippingServices or createShipment is compared against the new per‑second allowance. For instance, a script that fires 7 requests within one second will now be allowed 6 without penalty; the seventh request will receive a 429 until the next second begins.
- Burst accommodation — When traffic spikes, the system permits calls up to the newly defined burst ceiling. Example: during a flash‑sale, a seller’s integration may generate 11 simultaneous getEligibleShippingServices calls; the API will accept all 11 because the burst limit is 12, whereas previously only 10 would have succeeded.
Analysis & Recommendations
Why This Matters
Higher limits let sellers run more eligibility checks and shipment creations per second, reducing throttling‑induced retries and speeding order‑to‑ship flow. Adjusting pacing and monitoring 429 responses will keep integrations stable during peak sales.
Key Takeaways
- getEligibleShippingServices steady quota increased to 6 calls/sec (was 5).
- getEligibleShippingServices burst ceiling raised to 12 calls/sec (was 10).
- createShipment steady quota now 5 calls/sec (was 4).
- createShipment burst limit now 10 calls/sec (was 8).
Recommended Actions
- →Update your integration pacing logic (e.g., reduce pause to ~166 ms) in the code that calls getEligibleShippingServices and createShipment.
- →Add or adjust retry handling to read the Retry‑After header and back off exponentially; implement in your API client library.
- →Monitor 429 response counts in CloudWatch or your logging dashboard and set alerts for spikes.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!