---
updatedAt: 2026-09-04T15:46:06.000Z
---

# All orders

Call this endpoint to retrieve all orders for your account. You can use this endpoint to get a list of orders, their statuses, customer details, and fulfillment information.

> **Note:** Only orders from the last 180 days are available and you can fetch up to 10,000 orders at a time. If you try to get more than 10,000 orders, the API will return an error.
>
> **Note**: This page describes an example using only some common parameters and inputs for getting all orders. For a full list of customization options and additional capabilities, refer to the [Walmart Orders API Reference](/us-marketplace/reference/getallorders).

<div class="callout-light" role="note" aria-label="Note">

<b></b> If you receive <nocxemail@walmartone.com> instead of the customer email address, refer to the [Orders & returns FAQ](https://developer.walmart.com/us-marketplace/docs/orders-returns) for guidance on retrieving the updated email address.

</div>

## Endpoint

```Text bash
GET https://marketplace.walmartapis.com/v3/orders
```

## Sample request

This example shows you how to set the required headers, including your Base64-encoded credentials and a unique correlation ID, and how to structure your API call to retrieve all orders from your account. Use this sample as a starting point, then modify it with your actual values and any additional parameters described in the API reference.

```curl
curl --request GET \
     --url 'https://marketplace.walmartapis.com/v3/orders?limit=100&productInfo=false&shipNodeType=SellerFulfilled&replacementInfo=false&incentiveInfo=false' \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \
     --header 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \
     --header 'WM_SVC.NAME: Walmart Marketplace’ \
```
```python
import requests

url = "https://marketplace.walmartapis.com/v3/orders"
params = {
    "limit": 100,
    "productInfo": "false",
    "shipNodeType": "SellerFulfilled",
    "replacementInfo": "false",
    "incentiveInfo": "false",
}
headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "WM_QOS.CORRELATION_ID": "b3261d2d-028a-4ef7-8602-633c23200af6",
    "WM_SEC.ACCESS_TOKEN": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....",
    "WM_SVC.NAME": "Walmart Marketplace",
}

r = requests.get(url, headers=headers, params=params)
print(r.json())
```

### Modify your code

* Use a unique `WM_QOS.CORRELATION_ID` for each request.
* Replace `WM_SEC.ACCESS_TOKEN` with your valid access token obtained through authentication.

## Sample response

```json
{
  "list": {
    "meta": {
      "totalCount": 31,
      "limit": 10,
      "nextCursor": "?limit=10&hasMoreElements=true&soIndex=31&poIndex=10&partnerId=ABCDEF&sellerId=0123456&createdStartDate=YYYY-MM-DD&createdEndDate=YYYY-MM-DDTHH:MM:SS.sssZ"
    },
    "elements": {
      "order": [
        {
          "purchaseOrderId": "0123456789",
          "customerOrderId": "ABCDEFGHIJ",
          "customerEmailId": "example@relay.walmart.com",
          "orderType": "REPLACEMENT",
          "originalCustomerOrderID": "KLMNOPQRST",
          "orderDate": 1568466571000,
          "shippingInfo": {
            "phone": "0123456789",
            "estimatedDeliveryDate": 1569438000000,
            "estimatedShipDate": 1568700000000,
            "methodCode": "Value",
            "postalAddress": {
              "name": "John Doe",
              "address1": "1234 Example Rd",
              "address2": "Suite 100",
              "city": "Example City",
              "state": "EX",
              "postalCode": "12345",
              "country": "USA",
              "addressType": "RESIDENTIAL"
            }
          },
          "orderLines": {
            "orderLine": [
              {
                "lineNumber": "1",
                "item": {
                  "productName": "Example Product",
                  "sku": "SKU01234"
                },
                "charges": {
                  "charge": [
                    {
                      "chargeType": "PRODUCT",
                      "chargeName": "ItemPrice",
                      "chargeAmount": {
                        "currency": "USD",
                        "amount": 10
                      },
                      "tax": {
                        "taxName": "Tax1",
                        "taxAmount": {
                          "currency": "USD",
                          "amount": 0.8
                        }
                      }
                    }
                  ]
                },
                "orderLineQuantity": {
                  "unitOfMeasurement": "EACH",
                  "amount": "1"
                },
                "statusDate": 1568466647000,
                "orderLineStatuses": {
                  "orderLineStatus": [
                    {
                      "status": "Created",
                      "statusQuantity": {
                        "unitOfMeasurement": "EACH",
                        "amount": "1"
                      }
                    }
                  ]
                },
                "fulfillment": {
                  "fulfillmentOption": "S2H",
                  "shipMethod": "VALUE",
                  "pickUpDateTime": 1568919600000
                },
                "miscAttributes": {
                  "miscAttribute": [
                    {
                      "name": "PET_DETAILS",
                      "details": {
                        "detail": [
                          { "key": "PET_FIRST_NAME", "value": "Blue" },
                          { "key": "PET_LAST_NAME", "value": "Scarano" }
                        ]
                      }
                    },
                    {
                      "name": "VIRTUAL_PACK",
                      "details": {
                        "detail": [
                          { "key": "VIRTUAL_PACK_UNITS_ORDERED", "value": "1" },
                          { "key": "VIRTUAL_PACK_SIZE", "value": "3" },
                          { "key": "VIRTUAL_PACK_OFFER_ID", "value": "F84FC834C2143D8B9145C9953BFF15BC" }
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  }
}
```

An order response may include multiple `miscAttribute` groups when an item belongs to more than one program. For example, virtual packs can have a `VIRTUAL_PACK` group alongside any other applicable metadata groups.

## Result

If successful, the API responds with an `HTTP status: 200 OK` and a JSON payload containing a list of purchase orders with their details.

## Next step

[Retrieve all orders](/us-marketplace/docs/get-all-released-orders-1) with line items in the `Created `status that Walmart has released for processing.