Skip to content
Carts & CheckoutCustomer

List customer orders

Paginated customer order history with items, shipping address and payment totals

Query Parameters

limit?integer

Maximum number of results to return.

Formatint32
cursor?string

Cursor from the previous response. Omit it on the first page.

search?string

Free-text search.

sortBy?string

Field to sort by.

sortDirection?string

Sort direction: asc or desc.

Value in

  • "asc"
  • "desc"
status?string

Only items in these statuses.

Header Parameters

Authorization*string

OAuth 2.0 bearer token.

x-Store-Domain*string

Slug of the store or one of its configured domains, such as my-store.

Length1 <= length <= 253
X-Customer-Session?string

Customer session from POST /v1/customer/sessions. Send it instead of Authorization, never both.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://storefront.ecomiq.pe/v1/customer/orders" \  -H "Authorization: Bearer <token>" \  -H "x-Store-Domain: my-store" \  -H "X-Customer-Session: <session-id>"
{  "data": [    {      "orderId": "7204558912004325350",      "orderNumber": "ORD-2026-0001",      "orderGroup": "ORD-2026-0001",      "orderIds": [        "7204558912004325350"      ],      "status": "new",      "step": "pending",      "total": 178,      "totalPaid": 24,      "currencyCode": "PEN",      "orderDate": "2026-09-28T15:30:00Z",      "createdOn": "2026-09-28T15:30:00Z",      "updatedOn": "2026-09-28T15:30:00Z",      "paymentAt": "2026-09-28T15:30:00Z",      "shippingAddress": {        "address1": "Av. Larco 1234",        "city": "Lima",        "countryCode": "PE",        "name": "Mi tienda",        "company": "Comercial Lima SAC",        "address2": "Dpto. 501",        "province": "Lima",        "postalCode": "15074"      },      "shippingAddressSummary": "Clientes frecuentes",      "items": [        {          "id": "7204558912004326262",          "orderId": "7204558912004325350",          "productId": "7204558912004322039",          "variantId": "7204558912004323197",          "title": "Andrea Ramos",          "subtitle": "Andrea Ramos",          "thumbnail": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",          "variantTitle": "Andrea Ramos",          "productHandle": "polo-de-algodon",          "productUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",          "quantity": 2,          "unitPrice": 89,          "total": 178,          "status": "new",          "step": "pending",          "carrierName": "Courier Lima",          "trackingNumber": "PE1234567890",          "trackingLink": "https://tracking.example.com/PE1234567890",          "shippedAt": "2026-09-28T15:30:00Z",          "deliveredAt": "2026-09-28T15:30:00Z",          "modifiers": [            {              "id": "7204558912004325350",              "modifierGroupId": "7204558912004324624",              "modifierGroupName": "Personalización",              "modifierOptionId": "7204558912004327012",              "modifierOptionName": "Bordado",              "value": "Mi tienda",              "quantity": 2,              "priceDelta": 89            }          ]        }      ],      "payments": [        {          "id": "7204558912004326262",          "paymentMethod": "Tarjeta de crédito",          "paymentCode": "card",          "cardBrand": "Andrea Ramos",          "cardLast4": "Andrea Ramos",          "installments": 1,          "amount": 178,          "paymentStatus": "pending",          "receiptUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",          "createdOn": "2026-09-28T15:30:00Z"        }      ]    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}