Carritos y checkoutPedidos del cliente
Listar pedidos del cliente
Historial de pedidos del cliente con artículos, dirección de envío y totales de pago
Parámetros de consulta
limit?integer
Cantidad máxima de resultados por devolver.
Formato
int32cursor?string
Cursor de la respuesta anterior. Omítelo en la primera página.
search?string
Búsqueda de texto libre.
sortBy?string
Campo por el que se ordena.
sortDirection?string
Dirección del ordenamiento: asc o desc.
Valor en
- "asc"
- "desc"
status?string
Solo elementos en estos estados.
Parámetros de cabecera
x-Store-Domain*string
Slug de la tienda o uno de sus dominios configurados, como my-store.
Longitud
1 <= length <= 253X-Customer-Session?string
Sesión del cliente creada con POST /v1/customer/sessions. Envíala en lugar de Authorization, nunca las dos.
Cuerpo de la respuesta
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}