Overview

In June 2023 Amazon added the Replenishment API (version v2022‑11‑07) to the Selling Partner API family, delivering real‑time inventory and demand forecasts for each SKU. The service replaces older forecast endpoints and lets sellers programmatically calculate restock quantities, aiming to cut stock‑out incidents and streamline purchasing. Sellers who rely on timely replenishment should adopt the new API to keep pace with rapid demand shifts.

Key Points

• API version — Launched under version v2022‑11‑07, the Replenishment API supersedes the legacy inventory‑forecast endpoints and is the only supported method for automated demand projections.
• Performance data — The response includes daily sell‑through rates, on‑hand quantities, and projected demand, enabling calculations such as “average daily sales = 120 units over the past 30 days” for any listed SKU.
• Subscription model — Access is controlled through the Amazon Subscriptions API; sellers must explicitly enroll the Replenishment service in their developer profile before any forecast calls can be made.
• Rate limits — Amazon caps calls at 5 requests per second per seller, which equates to roughly 432,000 calls per day and requires careful throttling for high‑volume catalogs.
• Integration scope — Both FBA and FBM fulfillment models are supported, and the API returns separate replenishment suggestions for each channel, allowing mixed‑fulfillment strategies.
• Error handling — Standard JSON error codes (e.g., 400 for an invalid SKU, 429 for throttling) are returned, enabling developers to build automated retry and fallback logic in third‑party inventory tools.

How Replenishment API Works

1. Register the API — Sellers add the Replenishment service to their SP‑API subscription list via the developer console; for instance, a brand managing 2,000 SKUs must enable the service before any forecast data becomes available.
2. Submit a request — A POST call to /replenishment/v2022-11-07/forecast carries a JSON array of SKU identifiers and a horizon parameter, such as a 14‑day demand projection for 150 items, which Amazon then processes in real time.