Overview

On May 9 2024 Amazon launched version 2024‑05‑09 of its Warehousing and Distribution (W&D) API, inserting two new data groups—expiration information and preparation instructions—into inbound‑shipment queries. The addition lets sellers view each SKU’s on‑hand quantity together with its expiry date and see any mandatory packaging steps, which directly influences inventory planning, waste reduction, and compliance with Amazon’s inbound standards.

Key Points

• ExpirationDetails field — The listInventory call now returns a batch‑level expiration date, such as a 12‑oz jar of organic baby food that expires on 2024‑09‑15, alongside the quantity on hand.
• PrepDetails field — The getInboundShipment endpoint includes required prep actions; for example, a glass vase SKU may be flagged for “polybag + bubble‑wrap” and a “Fragile” label before it can enter the fulfillment center.
• Version‑specific endpoint — These enhancements are only accessible through the new version identifier v2024-05-09; requests to older versions continue to return the legacy payload without the new objects.
• Backward‑compatible response structure — Existing JSON schemas stay intact, with expirationDetails and prepDetails objects simply appended, allowing developers to upgrade incrementally without breaking current integrations.
• Enhanced demand forecasting — By matching inbound quantities to the freshest batches, sellers can avoid sending products that will expire shortly after arrival, thereby cutting disposal fees and lost sales.
• Automation of compliance work — Exposing prep requirements via API enables third‑party logistics (3PL) providers to generate packaging work orders automatically, removing manual checklist steps and reducing error rates.

How the Updated API Works

1. Invoke listInventory with the new version — Send a GET request to /wms/v2024-05-09/inventory with your seller identifier; the response returns an array where each entry contains , , and an object that lists (ISO 8601) and . : SKU  returns and .