Listar pedidos
Obtenga una lista paginada de sus pedidos (orders) con filtros opcionales.
GET /orders
Parámetros de consulta
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
page | integer | No | Número de página (predeterminado: 1) |
limit | integer | No | Elementos por página (predeterminado: 20, máx: 100) |
status | integer | No | Filtrar por código de estado del pedido (valor numérico del enum) |
productType | integer | No | Filtrar por tipo de producto: 1 = VIGNETTE, 2 = ESIM, 3 = INSURANCE, 4 = FINE_PAYMENT |
dateFrom | ISO 8601 | No | Filtrar pedidos creados a partir de esta fecha |
dateTo | ISO 8601 | No | Filtrar pedidos creados hasta esta fecha |
externalReference | string | No | Filtrar por su referencia externa |
Respuesta
{
"data": [
{
"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "COMPLETED",
"products": [
{
"productId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"productTypeId": 1,
"productName": "Austria 10-Day Vignette",
"quantity": 1,
"status": "COMPLETED"
}
],
"total": {
"amount": 11.5,
"currency": "EUR"
},
"externalReference": "YOUR-ORDER-REF-001",
"createdAt": "2026-03-20T14:30:00.000Z",
"completedAt": "2026-03-20T14:31:15.000Z"
},
{
"id": "ord-b2c3d4e5-f6a7-8901-bcde-f12345678901",
"status": "PENDING",
"products": [
{
"productId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"productTypeId": 2,
"productName": "Europe 10GB eSIM",
"quantity": 1,
"status": "PENDING"
}
],
"total": {
"amount": 24.99,
"currency": "EUR"
},
"externalReference": "YOUR-ORDER-REF-002",
"createdAt": "2026-03-20T15:00:00.000Z",
"completedAt": null
}
],
"meta": {
"page": 1,
"limit": 20,
"totalItems": 156,
"totalPages": 8
}
}