Listar gastos
GET /api/expenses
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Lista los gastos, del más reciente al más antiguo.
Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403. (en el listado, el vendedor solo ve los suyos).
Paginación por cursor: envía limit (1 a 100, por defecto 15). La respuesta trae pagination.next_cursor; para la página siguiente repite la misma consulta agregando cursor=<next_cursor>. Cuando pagination.has_more es false no hay más páginas.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
date_start |
query | no | 2026-11-01 |
Desde esta fecha de emisión (YYYY-MM-DD). |
date_end |
query | no | 2026-11-30 |
Hasta esta fecha de emisión. |
state_type_id |
query | no | 05 |
Filtra por estado (01, 05, 11). |
expense_reason_id |
query | no | 1 |
Filtra por motivo. |
expense_type_id |
query | no | 1 |
Filtra por tipo. |
search |
query | no | Busca por número del comprobante. | |
limit |
query | no | 15 |
Registros por página, de 1 a 100. Por defecto 15. |
cursor |
query | no | Valor de pagination.next_cursor de la respuesta anterior para obtener la página siguiente. |
Respuestas
200 — Listado
{
"success": true,
"data": [
{
"id": 25,
"external_id": "4f1c2b8e-7a9d-4d1e-9a3b-2c6e8f0a1b2c",
"number": "F001-4587",
"number_full": "F001-4587",
"date_of_issue": "2026-11-07",
"time_of_issue": "10:15:00",
"state_type_id": "05",
"state_type_description": "Aceptado",
"currency_type_id": "PEN",
"exchange_rate_sale": 1.0,
"total": 50.0,
"user_id": 5,
"establishment_id": 1,
"expense_type_id": 1,
"expense_type_description": "FACTURA",
"expense_reason_id": 2,
"expense_reason_description": "Servicios",
"supplier_id": 14,
"supplier": {
"name": "SERVICIOS GENERALES S.A.C.",
"number": "20456789123"
}
}
],
"pagination": {
"next_cursor": "eyJpZCI6MTUsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
"has_more": true
}
}
422 — Fecha inválida
{
"success": false,
"message": {
"date_start": [
"date start no es una fecha válida."
]
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.