Skip to main content
GET
https://api.zenflow.com.ar
/
api
/
v1
/
orders
Listar Pedidos
curl --request GET \
  --url https://api.zenflow.com.ar/api/v1/orders \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "orders": [
      {}
    ],
    "pagination": {
      "total": 123,
      "page": 123,
      "limit": 123,
      "total_pages": 123
    }
  }
}

​
Listar Pedidos

Obtén una lista de pedidos de tu tenant con filtrado y paginación opcionales.
Requiere scope read:orders.

​
Solicitud

GET /api/v1/orders

​
Parámetros de Consulta

​
page
integer
default:"1"
Número de página para paginación
​
limit
integer
default:"50"
Número de pedidos por página (máx 100)
​
state_id
integer | integer[]
Filtrar por ID(s) de estado del pedido
​
start_date
string
Filtrar pedidos creados en o después de esta fecha (YYYY-MM-DD)
​
end_date
string
Filtrar pedidos creados en o antes de esta fecha (YYYY-MM-DD)
​
assembly_date
string
Filtrar por fecha de ensamblaje/envío (YYYY-MM-DD)
​
include_details
boolean
default:"false"
Incluir líneas de pedido en la respuesta

​
Respuesta

​
success
boolean
Si la solicitud fue exitosa
​
data
object

​
Ejemplos

​
Solicitud Básica

curl -X GET "https://api.zenflow.com.ar/api/v1/orders?page=1&limit=20" \
  -H "X-API-Key: zenflow_live_your_key"

​
Respuesta

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": 12345,
        "order_tenant_id": "ORD-001",
        "state_id": 1,
        "state_name": "Pending",
        "assembly_date": "2024-01-15",
        "customer_name": "Juan Pérez",
        "items_count": 3,
        "created_at": "2024-01-14T10:30:00Z",
        "updated_at": "2024-01-14T10:30:00Z"
      },
      {
        "id": 12346,
        "order_tenant_id": "ORD-002",
        "state_id": 2,
        "state_name": "In Progress",
        "assembly_date": "2024-01-15",
        "customer_name": "María García",
        "items_count": 1,
        "created_at": "2024-01-14T11:00:00Z",
        "updated_at": "2024-01-14T14:30:00Z"
      }
    ],
    "pagination": {
      "total": 150,
      "page": 1,
      "limit": 20,
      "total_pages": 8
    }
  }
}

​
Con Filtros

curl -X GET "https://api.zenflow.com.ar/api/v1/orders?state_id=1&state_id=2&start_date=2024-01-01&include_details=true" \
  -H "X-API-Key: zenflow_live_your_key"

​
Respuestas de Error

​
401 No Autorizado

{
  "success": false,
  "error": {
    "code": "invalid_api_key",
    "message": "La API key proporcionada es inválida"
  }
}

​
403 Prohibido

{
  "success": false,
  "error": {
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido: read:orders"
  }
}