Saltar al contenido
Facturador

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.