Saltar al contenido
Facturador

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.