Amazon Warehousing and Distribution API

You can use the Amazon Warehousing and Distribution (AWD) API to create and update inbound orders to ship inventory to AWD distribution centers, track inventory inside AWD distribution centers, and track shipments on the way to AWD distribution centers. For information about AWD API operations, data types, and schemas, refer to the Amazon Warehousing and Distribution API Reference.

📘

Note

This API is available in the US marketplace.

To learn more about the terms that are used on this page, refer to Terminology.

📘

Note

You can find the information on AWD fees in Seller Central.

Use cases

Key tasks that you can perform with the Amazon Warehousing and Distribution API include:

• Verify AWD inbound eligibility and create inbound orders with a region preference.
• Update one or more individual attributes for an inbound order, such as the packagesToInbound, originAddress, and preferences attributes.
• Cancel an inbound order.
• Retrieve all inbound shipments across orders with optional filters.
• Retrieve inbound shipments with optional filters and access shipment details with SKU-specific attributes.
• Retrieve box labels for confirmed inbound shipments.
• Update transport information for an AWD inbound shipment.
• Return real-time information, such as expiration dates, about the inventory within an AWD distribution center and units that are reserved by a replenishment order. Return quantity information for units that are in transit to AWD or from AWD to a Fulfillment by Amazon (FBA) facility.
• Access inbound orders that you create with Amazon's Send to Amazon Warehousing and Distribution UI.

📘

Note

Interoperability between API and Seller Central is currently limited. It is possible to see your shipments created with the API in Seller Central as soon as they are confirmed. Conversely, after you successfully create a shipment in Seller Central, you can view your shipment details through getInboundShipment or listInboundShipments operation.

The following use case examples are available for the Amazon Warehousing and Distribution API v2024-05-09:

• Create an inbound order for shipment: Create, update, and confirm inbound labels and general box labels for tracking.
• Retrieve and filter inbound shipments: Retrieve and filter a list of inbound shipments for a specific time.
• Track an inbound shipment with expected and received SKU details: Retrieve a particular AWD inbound shipment which contains items that are planned to be inbounded to a distribution center. For each SKU, you can also retrieve expiration dates and prep details.
• Get inventory summaries: Get all available inventory summaries for a specific SKU.

AWD inbound shipment workflow

The following diagram shows the steps to ship inventory to an AWD distribution center. This is an illustrative example and does not include all of the optional operations.

Roles for the Amazon Warehousing and Distribution API v2024-05-09

📘

Note

Ensure that the AWD role is added to your application. After adding a new role, your application needs to be re-authorized. In some cases, you may also need to re-list your application in the Selling Partner Appstore.