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.
Format
int32cursor?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
x-Store-Domain*string
Slug of the store or one of its configured domains, such as my-store.
Length
1 <= length <= 253X-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}