Amazon Warehousing and Distribution API

Learn how to work with Amazon Warehousing and Distribution (AWD) orders using the 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.

Current versionLegacy versionsAvailable to sellersAvailable to vendors
v2024-05-09 (Reference | Model)NoneYesNo
Release notes

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

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.

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

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.

The AWD inbound shipment workflow.

Roles

getInboundShipment
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
listInboundShipments
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
listInventory
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
createInbound
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
getInbound
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
updateInbound
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
cancelInbound
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
confirmInbound
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
getInboundShipmentLabels
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
updateInboundShipmentTransportDetails
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution
checkInboundEligibility
AttributeValue
RegionsNA, EU, FE
Required roles (need at least one)Amazon Warehousing and Distribution