---
updatedAt: 2026-05-05T17:13:52.000Z
---
# Retrieve all released orders
This request retrieves all the orders with line items in `Created` status.
These orders have been released from the Walmart Order Management System (OMS) to the supplier for processing. Released orders are ready for supplier fulfillment.
Only orders created in last 180 days can be fetched, and a maximum of 20,000 orders can be fetched and downloaded at a time. Attempting to download more than 20,000 orders will return an error.
{`
`}
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "DSV Order Management",
"description": "Drop ship vendors (DSVs) use the DSV Order Management API to stay up to date on order fulfillment.\n",
"version": "1.0",
"contact": {
"name": "contact name"
}
},
"x-readme": {
"samples-languages": [
"shell"
],
"proxy-enabled": false,
"explorer-enabled": true
},
"servers": [
{
"url": "https://api-gateway.walmart.com",
"description": "Production URL"
},
{
"url": "https://sandbox.walmartapis.com",
"description": "Sandbox URL"
}
],
"tags": [
{
"name": "DSV Orders"
}
],
"paths": {
"/v3/orders/released": {
"get": {
"tags": [
"DSV Orders"
],
"operationId": "retrieveAllReleasedOrders",
"summary": "Retrieve all released orders",
"description": "This request retrieves all the orders with line items in `Created` status.\n\nThese orders have been released from the Walmart Order Management System (OMS) to the supplier for processing. Released orders are ready for supplier fulfillment.\n\nOnly orders created in last 180 days can be fetched, and a maximum of 20,000 orders can be fetched and downloaded at a time. Attempting to download more than 20,000 orders will return an error.",
"parameters": [
{
"in": "query",
"name": "shipNode",
"required": true,
"schema": {
"type": "string"
},
"description": "Distribution facility distributor identifier.\n\nThis parameter identifies the facility from which the inventory is requested. Facility identifiers are autogenerated during account creation, when adding new facilities, and when updating existing facilities in Supplier Center. Take care to use the latest value for your desired facility.\n",
"example": "123456701"
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"type": "string"
},
"description": "Specifies the number of purchase orders to be returned. This value cannot be greater than 200.\n",
"example": "100"
},
{
"in": "query",
"name": "sku",
"required": false,
"schema": {
"type": "string"
},
"description": "Specifies the stock keeping unit (SKU) item identifier.\n\nThis identifier is an arbitrary alphanumeric identifier specified by the DSV.\n\nSpecial characters that require encoding include: `:`, `/`, `?`, `#`, `[`, `]`, `@`, `!`, `$`, `&`, `'`, `(`, `)`, `*`, `+`, `,`, `;`, `=`, `{`, `}`, and `%`.\n\nEncode spaces as `%20`.\n",
"example": "06194456252572"
},
{
"in": "query",
"name": "customerOrderId",
"required": false,
"schema": {
"type": "string"
},
"description": "Customer purchase order identifier.",
"example": "6101730068963"
},
{
"in": "query",
"name": "purchaseOrderId",
"required": false,
"schema": {
"type": "string"
},
"description": "Unique identifier associated of the purchase order.",
"example": "2581154514813"
},
{
"in": "query",
"name": "createdStartDate",
"required": false,
"schema": {
"type": "string"
},
"description": "Starting date for the query date range.\n\nThis query fetches all purchase orders created after this date. The default is the current date minus seven days.\n\nUse either the yyyy-MM-dd or yyyy-MM-dd'T'HH:mm:ssZ [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).\n",
"example": "2025-10-31T13:03:33.000Z"
},
{
"in": "query",
"name": "createdEndDate",
"required": false,
"schema": {
"type": "string"
},
"description": "Ending date for the query date range.\n\nThis query fetches all purchase orders created before this date. The default is the current date minus seven days.\n\nUse either the yyyy-MM-dd or yyyy-MM-dd'T'HH:mm:ssZ [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).\n",
"example": "2025-10-31T13:03:33.000Z"
},
{
"in": "query",
"name": "fromExpectedShipDate",
"required": false,
"schema": {
"type": "string"
},
"description": "Starting expected ship date range for the query.\n\nThis query fetches all purchase orders that have order lines with an expected ship date after this date.\n\nUse either the yyyy-MM-dd or yyyy-MM-dd'T'HH:mm:ssZ [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).\n",
"example": "2025-10-31T13:03:33.000Z"
},
{
"in": "query",
"name": "toExpectedShipDate",
"required": false,
"schema": {
"type": "string"
},
"description": "Ending expected ship date range for the query.\n\nThis query fetches all purchase orders that have order lines with an expected ship date before this date.\n\nUse either the yyyy-MM-dd or yyyy-MM-dd'T'HH:mm:ssZ [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).\n",
"example": "2025-10-31T13:03:33.000Z"
},
{
"in": "query",
"name": "productInfo",
"required": false,
"schema": {
"type": "string"
},
"description": "Specifies whether or not to include the image URL and product weight in the response, if available.\n\nIf `true`, the image URL and product weight are provided in the response. If `false`, the image URL and product weight are not provided in the response.\n",
"example": "false"
},
{
"in": "header",
"name": "Accept",
"required": false,
"schema": {
"type": "string"
},
"description": "Specifies the data type expected in a response sent from the server.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| application/json | JSON format for data returned in response. |\n| application/xml | XML format for data returned in response. |\n",
"example": "application/xml"
},
{
"in": "header",
"name": "WM_CONSUMER.CHANNEL.TYPE",
"required": false,
"schema": {
"type": "string"
},
"description": "Identifier that tracks the consumer request by channel.\n\nUse the consumer channel type received during your onboarding. Contact your system administrator or developer management for the correct `WM_CONSUMER.CHANNEL.TYPE` value.\n",
"example": "0f3e4dd4-0514-4346-b39d-…"
},
{
"in": "header",
"name": "WM_QOS.CORRELATION_ID",
"required": true,
"schema": {
"type": "string"
},
"description": "Unique identifier for each API call, used to track and debug issues.\n\nUse a randomly generated GUID for this ID.\n",
"example": "16338294-795c-44eb-97cd-37967f8532e5"
},
{
"in": "header",
"name": "WM_SEC.ACCESS_TOKEN",
"required": true,
"schema": {
"type": "string"
},
"description": "Access token returned by the [Create access token request](https://developer.walmart.com/suppliers/reference/postcreateanaccesstoken).\n\nThis value is required for token-based authentication.\n",
"example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM…"
}
],
"responses": {
"200": {
"description": "Successful Operation",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"meta": {
"type": "object",
"description": "Contains metadata about the query response list.",
"properties": {
"totalCount": {
"type": "integer",
"format": "int32",
"description": "Total number of returned purchase orders.",
"example": 44
},
"limit": {
"type": "integer",
"format": "int32",
"description": "Number of purchase orders on the current search results page.",
"example": 2
},
"nextCursor": {
"type": "string",
"description": "Indicates the value set to get the next set of purchase orders, when more than 200 orders are retrieved.",
"example": "?limit=2&hasMoreElements=true&soIndex=44&poIndex=2&sellerId=0&status=Created&createdStartDate=2017-07-27&createdEndDate=2018-12-05T10:18:45.557Z&shipNode=837252"
}
}
},
"elements": {
"type": "object",
"description": "Contains elements of the list of query results.",
"properties": {
"order": {
"type": "array",
"description": "List of objects containing purchase order information.",
"items": {
"type": "object",
"properties": {
"purchaseOrderId": {
"type": "string",
"description": "Unique identifier associated of the purchase order.",
"example": "2581154514813"
},
"customerOrderId": {
"type": "string",
"description": "Customer purchase order identifier.",
"example": "6251732862080"
},
"customerEmailId": {
"type": "string",
"description": "Email address of the sales order customer.",
"example": "johndoe@email"
},
"orderDate": {
"type": "integer",
"format": "int64",
"description": "Date and time when customer submitted the sales order, in Unix format.",
"example": 1513812227000
},
"shippingInfo": {
"type": "object",
"description": "Contains shipping information provided to you by the customer.",
"properties": {
"phone": {
"type": "string",
"description": "Customer phone number.",
"example": "6505852323"
},
"estimatedDeliveryDate": {
"type": "string",
"format": "date-time",
"description": "Estimated date and time for the delivery of the item, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).\n",
"example": "2025-10-31T13:03:33.000Z"
},
"estimatedShipDate": {
"type": "string",
"format": "date-time",
"description": "Estimated date and time when the item will be shipped, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).\n",
"example": "2025-10-31T13:03:33.000Z"
},
"methodCode": {
"type": "string",
"description": "Shipping method code.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| Express | Express shipping method. |\n| Freight | Freight shipping method. |\n| OneDay | One-day shipping method. |\n| Standard | Standard shipping method. |\n| Value | Value shipping method. |\n| WhiteGlove | White glove shipping method. |\n",
"example": "Standard",
"enum": [
"Standard",
"Express",
"OneDay",
"Freight",
"WhiteGlove",
"Value"
]
},
"postalAddress": {
"type": "object",
"description": "Contains the customer postal address.",
"properties": {
"name": {
"type": "string",
"description": "Name associated with the shipment.",
"example": "Jordan Smith"
},
"address1": {
"type": "string",
"description": "Postal address number and street .",
"example": "1357 Main St"
},
"address2": {
"type": "string",
"description": "Additional address information.",
"example": "Suite 2B"
},
"city": {
"type": "string",
"description": "Postal address city.",
"example": "Fremont"
},
"state": {
"type": "string",
"description": "Postal address state.",
"example": "CA"
},
"postalCode": {
"type": "string",
"description": "United States ZIP Code.",
"example": "94536"
},
"country": {
"type": "string",
"description": "Postal address country.",
"example": "USA"
},
"addressType": {
"type": "string",
"description": "Address type.",
"example": "RESIDENTIAL"
}
}
}
}
},
"orderLines": {
"type": "object",
"description": "Contains a list of line items in the order.",
"properties": {
"orderLine": {
"type": "array",
"description": "List of objects containing purchase order line information for each item.",
"items": {
"type": "object",
"properties": {
"lineNumber": {
"type": "string",
"description": "Line number of the individual item in the purchase order.",
"example": "1"
},
"item": {
"type": "object",
"description": "Contains purchase order line item information.",
"properties": {
"productName": {
"type": "string",
"description": "Product name of the line item.",
"example": "Photo Necktie (Printed on 2 Sides)"
},
"sku": {
"type": "string",
"description": "Stock keeping unit (SKU) item identifier.",
"example": "1487132332472"
},
"gtin": {
"type": "number",
"description": "14-digit Global Trade Item Number (GTIN).",
"example": 4692941898264
}
}
},
"charges": {
"type": "object",
"description": "Contains purchase order line charge information.",
"properties": {
"charge": {
"type": "array",
"description": "List of charge information objects.",
"items": {
"type": "object",
"properties": {
"chargeType": {
"type": "string",
"description": "Charge type for purchase order line items.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| PRODUCT | Product charges for the purchase order line item. |\n| SHIPPING | Shipping charges for the purchase order line item. |\n\nFor more about charge types, refer to [Drop Ship Vendor (DSV) Order Charge Types](/suppliers/docs/drop-ship-vendor-dsv-order-management-api-overview#drop-ship-vendor-dsv-order-charge-types).\n",
"example": "PRODUCT"
},
"chargeName": {
"type": "string",
"description": "Charge name.\n\nIf the `chargeType` is `PRODUCT`, the charge name is `Item Price`.\n\nIf the `chargeType` is `SHIPPING`, the charge name is `Shipping`.\n",
"example": "Item Price"
},
"chargeAmount": {
"type": "object",
"description": "Contains charge amount information.",
"properties": {
"currency": {
"type": "string",
"description": "[ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) of the charge.\n\nValue values include, but are not limited to:\n\n| Value | Meaning |\n| --- | --- |\n| CAD | Canadian Dollar |\n| GBP | Great Britain Pound |\n| USD | United States Dollar|\n",
"example": "USD"
},
"amount": {
"type": "number",
"description": "Amount charged.",
"example": 9.99
}
}
},
"tax": {
"type": "object",
"description": "Contains tax information for the charge.",
"properties": {
"taxName": {
"type": "string",
"description": "Name of the tax charged.",
"example": "Sales Tax"
},
"taxAmount": {
"type": "object",
"description": "Contains details about the amount of tax charged.",
"properties": {
"currency": {
"type": "string",
"description": "[ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) of the charge.\n\nValue values include, but are not limited to:\n\n| Value | Meaning |\n| --- | --- |\n| CAD | Canadian Dollar |\n| GBP | Great Britain Pound |\n| USD | United States Dollar |\n",
"example": "USD"
},
"amount": {
"type": "number",
"description": "Charge amount.",
"example": 9.99
}
}
}
}
}
}
},
"example": [
{
"chargeType": "PRODUCT",
"chargeName": "Item Price",
"chargeAmount": {
"currency": "USD",
"amount": 9.99
}
},
{
"chargeType": "PRODUCT",
"chargeName": "Item Price",
"chargeAmount": {
"currency": "USD",
"amount": 7.99
}
},
{
"tax": {
"taxName": "Sales Tax",
"taxAmount": {
"currency": "USD",
"amount": 9.99
}
}
}
]
}
}
},
"orderLineQuantity": {
"type": "object",
"description": "Contains line item quantity information.",
"properties": {
"unitOfMeasurement": {
"type": "string",
"description": "Line item unit of measurement.\n\nValid values are:\n| Value | Meaning |\n| --- | --- |\n| EA | Each unit of measurement |\n| EACH | Each unit of measurement |\n",
"enum": [
"EACH",
"EA"
],
"example": "EACH"
},
"amount": {
"type": "string",
"description": "Line item quantity.",
"example": "1"
}
}
},
"statusDate": {
"type": "string",
"format": "date-time",
"description": "Date and time of the the most recent order status, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).",
"example": "2025-10-31T13:03:33.000Z"
},
"orderLineStatuses": {
"type": "object",
"description": "Contains a list of objects detailing purchase order line statuses.",
"properties": {
"orderLineStatus": {
"type": "array",
"description": "List of objects detailing purchase order line item statuses.",
"items": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Status of the order line.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| Acknowledged | The purchase order line has been acknowledged. |\n| Cancelled | The purchase order line has been cancelled. |\n| Created | The purchase order line has been created. |\n| Delivered | The purchase order line has been delivered. |\n| Refund | The purchase order line has been refunded. |\n| Shipped | The purchase order line has been shipped. |\n\nThe `status` value should be `Created`.\n",
"example": "Created",
"enum": [
"Created",
"Acknowledged",
"Shipped",
"Delivered",
"Cancelled",
"Refund"
]
},
"statusQuantity": {
"type": "object",
"description": "Contains details about the quantity of line items in a particular state.",
"required": [
"unitOfMeasurement",
"amount"
],
"properties": {
"unitOfMeasurement": {
"type": "string",
"description": "Line item unit of measure.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| EA | Each unit of measurement |\n| EACH | Each unit of measurement |\n",
"enum": [
"EACH",
"EA"
],
"example": "EACH"
},
"amount": {
"type": "string",
"description": "Line item quantity.",
"example": "1"
}
}
},
"cancellationReason": {
"type": "string",
"description": "Order cancellation reason.",
"example": "SUPPLIER_CANCEL_BACKORDER"
},
"trackingInfo": {
"type": "object",
"description": "Contains tracking information.",
"properties": {
"shipDateTime": {
"type": "string",
"format": "date-time",
"description": "Date and time when the package was shipped, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).",
"example": "2025-10-31T13:03:33.000Z"
},
"carrierName": {
"type": "object",
"description": "Contains package carrier information.",
"properties": {
"otherCarrier": {
"type": "string",
"description": "Secondary package shipment carrier name.",
"example": "USPS"
},
"carrier": {
"type": "string",
"enum": [
"UPS",
"USPS",
"FedEx",
"Airborne",
"OnTrac",
"DHL",
"LS",
"UDS",
"UPSMI",
"FDX",
"FEDEXSP"
],
"description": "Package shipment carrier name.\n\nValid values are:\n\n| Value | Meaning \n| --- | --- |\n| Airborne | Airborne |\n| DHL | DHL Ecommerce - US |\n| FDX | FedEx |\n| FedEx | Federal Express |\n| FEDEXSP | FedEx SmartPost |\n| LS | LaserShip |\n| OnTrac | OnTrac |\n| UDS | United Delivery Service |\n| UPS | United Postal Service |\n| UPSMI | UPS Main Innovations |\n| USPS | United States Postal Service |\n",
"example": "USPS"
}
}
},
"methodCode": {
"type": "string",
"description": "Shipping method code.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| Express | Express shipping method |\n| Freight | Freight shipping method |\n| OneDay | One-day shipping method |\n| Standard | Standard shipping method |\n| Value | Value shipping method |\n| WhiteGlove | White glove shipping method |\n",
"enum": [
"Standard",
"Express",
"OneDay",
"Freight",
"WhiteGlove",
"Value"
],
"example": "Standard"
},
"trackingNumber": {
"type": "string",
"description": "Shipment tracking number.",
"example": "2025-10-31T13:03:33.000Z"
},
"trackingUrl": {
"type": "string",
"description": "URL for tracking the shipment.",
"example": "www.genericshipmentcompany.tracking.com"
}
}
}
}
}
}
}
},
"refund": {
"type": "object",
"description": "Contains order refund details.",
"properties": {
"refundId": {
"type": "string",
"description": "Refund identifier.",
"example": "135790"
},
"refundComments": {
"type": "string",
"description": "Descriptive comment about the refund.",
"example": "Billing error"
},
"refundCharges": {
"type": "object",
"description": "Contains charge refund details.",
"properties": {
"refundCharge": {
"type": "array",
"description": "List of objects containing charge refund information.",
"items": {
"type": "object",
"properties": {
"refundReason": {
"type": "string",
"description": "Refund reason.",
"example": "BillingError",
"enum": [
"BillingError",
"TaxExemptCustomer",
"ItemNotAsAdvertised",
"IncorrectItemReceived",
"CancelledYetShipped",
"ItemNotReceivedByCustomer",
"IncorrectShippingPrice",
"DamagedItem",
"DefectiveItem",
"CustomerChangedMind",
"CustomerReceivedItemLate",
"Finance -> Goodwill",
"Finance -> Rollback",
"Missing Parts / Instructions",
"Buyer canceled",
"Customer returned item",
"General adjustment",
"Merchandise not received",
"Quality -> Missing Parts / Instructions",
"Shipping & Delivery -> Damaged",
"Shipping & Delivery -> Shipping Price Discrepancy",
"Others"
]
},
"charge": {
"type": "object",
"description": "Charge refund details.",
"properties": {
"chargeType": {
"type": "string",
"description": "Charge type for purchase order line items.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| PRODUCT | Product charges for the purchase order line item. |\n| SHIPPING | Shipping charges for the purchase order line item. |\n\nFor more about charge types, refer to [Drop Ship Vendor (DSV) Order Charge Types](/suppliers/docs/drop-ship-vendor-dsv-order-management-api-overview#drop-ship-vendor-dsv-order-charge-types).\n",
"example": "PRODUCT"
},
"chargeName": {
"type": "string",
"description": "Charge name.\n\nIf the `chargeType` is `PRODUCT`, the charge name is `Item Price`.\n\nIf the `chargeType` is `SHIPPING`, the charge name is `Shipping`.\n",
"example": "Item Price"
},
"chargeAmount": {
"type": "object",
"description": "Contains charge amount information.",
"properties": {
"currency": {
"type": "string",
"description": "[ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) of the charge.\n\nValue values include, but are not limited to:\n\n| Value | Meaning |\n| --- | --- |\n| CAD | Canadian Dollar |\n| GBP | Great Britain Pound |\n| USD | United States Dollar|\n",
"example": "USD"
},
"amount": {
"type": "number",
"description": "Amount charged.",
"example": 9.99
}
}
},
"tax": {
"type": "object",
"description": "Contains tax information for the charge.",
"properties": {
"taxName": {
"type": "string",
"description": "Name of the tax charged.",
"example": "Sales Tax"
},
"taxAmount": {
"type": "object",
"description": "Contains details about the amount of tax charged.",
"properties": {
"currency": {
"type": "string",
"description": "[ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) of the charge.\n\nValue values include, but are not limited to:\n\n| Value | Meaning |\n| --- | --- |\n| CAD | Canadian Dollar |\n| GBP | Great Britain Pound |\n| USD | United States Dollar |\n",
"example": "USD"
},
"amount": {
"type": "number",
"description": "Charge amount.",
"example": 9.99
}
}
}
}
}
}
}
}
}
}
}
}
}
},
"originalCarrierMethod": {
"type": "string",
"description": "Original carrier method.",
"example": "20"
},
"referenceLineId": {
"type": "string",
"description": "Reference line identifier.",
"example": "135642"
},
"fulfillment": {
"type": "object",
"description": "Contains order fulfillment information.",
"properties": {
"fulfillmentOption": {
"type": "string",
"description": "Fulfillment option, such as ship to home (S2H).",
"example": "S2H"
},
"shipMethod": {
"type": "string",
"description": "Indicates the shipping method.\n\nValid values are:\n\n| Value | Meaning |\n| --- | --- |\n| EXPRESS | Express shipping method. |\n| FREIGHT | Freight shipping method. |\n| ONEDAY | One-day shipping method. |\n| STANDARD | Standard shipping method. |\n| VALUE | Value shipping method. |\n| WHITEGLOVE | White glove shipping method. |\n",
"example": "STANDARD"
},
"storeId": {
"type": "string",
"description": "External store identifier.",
"example": "9221"
},
"offerId": {
"type": "string",
"description": "Offer identifier.",
"example": "1357908642DFE"
},
"pickUpDateTime": {
"type": "string",
"format": "date-time",
"description": "Date and time when the order was picked up, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).",
"example": "2025-10-31T13:03:33.000Z"
},
"pickUpBy": {
"type": "string",
"description": "Date and time by which the order must be picked up, in [ISO 8601 format](https://www.iso.org/iso-8601-date-and-time-format.html).",
"example": "2025-10-31T13:03:33.000Z"
}
}
},
"intentToCancel": {
"type": "string",
"description": "Intent to cancel.",
"example": "Intent"
},
"configId": {
"type": "string",
"description": "Configuration identifier.",
"example": "13579GLG"
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
}
},
"x-tagGroups": [
{
"name": "1P Suppliers DSV Orders Reference",
"tags": [
"DSV Orders",
"Bulk Download"
]
}
]
}
```