Listar ingresos
GET /api/incomes
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Lista los ingresos, 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. |
state_type_id |
query | no | 05 |
Filtra por estado. |
income_reason_id |
query | no | 1 |
Filtra por motivo. |
income_type_id |
query | no | 1 |
Filtra por tipo. |
search |
query | no | Busca por número. | |
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": 8,
"external_id": "9b2d4e6f-1a3c-4b5d-8e7f-0a1b2c3d4e5f",
"number": "1",
"number_full": "ING-1",
"date_of_issue": "2026-11-07",
"time_of_issue": "11:20:00",
"state_type_id": "05",
"state_type_description": "Aceptado",
"currency_type_id": "PEN",
"exchange_rate_sale": 1.0,
"total": 120.0,
"user_id": 5,
"establishment_id": 1,
"income_type_id": 1,
"income_type_description": "Otros ingresos",
"income_reason_id": 1,
"income_reason_description": "Aporte de socio",
"customer": "CARLOS RAMIREZ"
}
],
"pagination": {
"next_cursor": null,
"has_more": false
}
}
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.