---
title: "listReplenishmentOrders"
method: GET
path: "/awd/2024-05-09/replenishmentOrders"
tags: ["Amazon Warehousing and Distribution v2024-05-09"]
---

# listReplenishmentOrders

`GET /awd/2024-05-09/replenishmentOrders`

## Request

- Base URL: `https://sellingpartnerapi-na.amazon.com`
- URL: `https://sellingpartnerapi-na.amazon.com/awd/2024-05-09/replenishmentOrders`
- Auth: none declared

Retrieves all the AWD replenishment orders pertaining to a merchant with optional filters.
API by default will sort orders by updatedAt attribute in descending order.

## Query parameters

- `updatedAfter` string, date-time
- `updatedBefore` string, date-time
- `sortOrder` 'ASCENDING' | 'DESCENDING'
- `maxResults` integer
- `nextToken` string

## Response `200`

ListReplenishmentOrders 200 response

- ReplenishmentOrderListing: A list of paginated replenishment orders filtered by the attributes passed in the request.
  - `nextToken` string: A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.
  - `orders` ReplenishmentOrder[]: List of replenishment orders.
    - `confirmedOn` string, date-time: Date on which this replenishment order was confirmed.
    - `createdAt` string, date-time: Date on which this replenishment order was created.
    - `distributionIneligibleReasons` DistributionIneligibleReason[]: Distribution errors associated with the order related to the products or packages to replenish. This field will be populated if the order has products or packages which failed validation.
      - `failureCode` string, required: Failure code details of the error.
      - `failureReasons` string[], required: Failure reasons of the error.
      - `sku` string: SKU associated with the error.
    - `eligibleProducts` DistributionProduct[]: List of product units that are eligible for replenishment.
      - `attributes` ProductAttribute[]: Attributes for this instance of the product, i.e. already-prepped, or other attributes that distinguish the product beyond the SKU.
        - `name` string: Product attribute name.
        - `value` string: Product attribute value.
      - `quantity` integer, required: Quantity of the product
      - `sku` string, required: The seller/merchant stock keeping unit (SKU).
    - `orderId` string, required: Order Id of the replenishment order.
    - `status` 'CONFIRMED' | 'CREATED' | 'ELIGIBLE' | 'EXECUTING' | 'FAILURE' | 'INELIGIBLE' | 'INVENTORY_OUTBOUND' | 'SUCCESS' | 'VALIDATING', required: Statuses supported for an replenishment order.
    - `outboundShipments` OutboundShipmentSummary[], required: List of outbound shipments that are part of this order.
      - `createdAt` string, date-time: Timestamp denoting when the shipment was created
      - `orderId` string, required: Order ID of AWD inbound order this inbound shipment belongs to
      - `shipmentId` string, required: Unique shipment ID
      - `shipmentStatus` 'CREATED' | 'IN_TRANSIT' | 'DELIVERED' | 'RECEIVING' | 'RECEIVED' | 'CLOSED' | 'CANCELLED' | 'FAILED', required: Possible shipment statuses for outbound shipments.
      - `updatedAt` string, date-time: Timestamp denoting when the shipment was updated
    - `products` DistributionProduct[]: Requested amount of single product units to be replenished.
      - `attributes` ProductAttribute[]: Attributes for this instance of the product, i.e. already-prepped, or other attributes that distinguish the product beyond the SKU.
        - `name` string: Product attribute name.
        - `value` string: Product attribute value.
      - `quantity` integer, required: Quantity of the product
      - `sku` string, required: The seller/merchant stock keeping unit (SKU).
    - `shippedProducts` DistributionProduct[]: Outbound product units that are shipped after the execution has completed post confirmation.
      - `attributes` ProductAttribute[]: Attributes for this instance of the product, i.e. already-prepped, or other attributes that distinguish the product beyond the SKU.
        - `name` string: Product attribute name.
        - `value` string: Product attribute value.
      - `quantity` integer, required: Quantity of the product
      - `sku` string, required: The seller/merchant stock keeping unit (SKU).
    - `updatedAt` string, date-time: Date on which this replenishment order was last updated.

## Other responses

- `400`: Request has missing or invalid parameters and cannot be parsed.
- `403`: Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404`: The resource specified does not exist.
- `413`: The request size exceeded the maximum accepted size.
- `415`: The request payload is in an unsupported format.
- `429`: The frequency of requests was greater than allowed.
- `500`: An unexpected condition occurred that prevented the server from fulfilling the request.
- `503`: Temporary overloading or maintenance of the server.

---

[API](https://skmtc.dev/aws-samples/apis/a-content-management-v2020-11-01.md) - [All operations](https://skmtc.dev/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) - [OpenAPI document](https://skmtc.dev/aws-samples/apis/a-content-management-v2020-11-01/revisions/815a5b6dbaa6?raw)