Saltar al contenido
docs
Guías
EN
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

GET/v1/customer/orders

Historial de pedidos del cliente con artículos, dirección de envío y totales de pago

Autorización

bearerAuth
AutorizaciónBearer <token>

Token de acceso OAuth 2.0 emitido por Ecomiq Auth.

Ubicación: header

Parámetros de consulta

limit?integer

Cantidad máxima de resultados por devolver.

Formatoint32
cursor?string

Cursor opaco de la respuesta anterior. Omítelo en la primera página.

search?string

Filtro de texto libre. Los campos consultados dependen del recurso.

sortBy?string

Campo de ordenamiento. Los valores admitidos dependen del recurso.

sortDirection?string

Dirección del ordenamiento: asc o desc.

Valor en

  • "asc"
  • "desc"

Parámetros de cabecera

Authorization*string

Token bearer OAuth 2.0.

x-Store-Domain*string

Slug o dominio configurado que selecciona el contexto de tienda en el gateway central de Storefront.

Longitud1 <= length <= 253

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://example.com/v1/customer/orders" \  -H "Authorization: Bearer <token>" \  -H "x-Store-Domain: my-store"
{  "data": [    {      "orderId": "7204558912004325301",      "orderNumber": "ORD-2026-0001",      "orderGroup": "example",      "orderIds": [        "example"      ],      "status": "new",      "total": 1,      "totalPaid": 1,      "currencyCode": "PEN",      "orderDate": "2026-08-01T15:30:00Z",      "createdOn": "2026-08-01T15:30:00Z",      "updatedOn": "2026-08-01T15:30:00Z",      "paymentAt": "2026-08-01T15:30:00Z",      "shippingAddress": {        "address1": "example",        "city": "example",        "countryCode": "PE",        "name": "Example resource",        "company": "example",        "address2": "example",        "province": "example",        "postalCode": "example_code"      },      "shippingAddressSummary": "example",      "items": [        {          "id": "7204558912004325301",          "orderId": "7204558912004325301",          "productId": "7204558912004325301",          "variantId": "7204558912004325301",          "title": "Example title",          "subtitle": "Example title",          "thumbnail": "example",          "variantTitle": "Example title",          "productHandle": "example",          "quantity": 1,          "unitPrice": 1,          "total": 1,          "status": "new"        }      ]    }  ],  "hasNextPage": false,  "nextCursor": "example",  "totalCount": 1}