---
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`

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.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)