Saltar al contenido
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.

Formatoint32
cursor?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

Authorization*string

Token bearer OAuth 2.0.

x-Store-Domain*string

Slug de la tienda o uno de sus dominios configurados, como my-store.

Longitud1 <= length <= 253
X-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}