Listar egresos
Gastos del negocio, paginados por cursor. Requiere el módulo de egresos en el plan además del permiso expenses.read.
Autorización
apiKey expenses.readLa llave del negocio, creada en el panel: Integraciones → API pública. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».
Va en: header
Permiso: expenses.read
Parámetros de consulta
Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios; con uno solo, se deduce.
Filas por página.
1 <= value <= 10050Cursor: el nextCursor de la página anterior.
Categoría de gasto. Repetible.
Sucursal. Repetible.
Monto mínimo, en pesos. Admite centavos (hasta 2 decimales): 1100.5 son $1.100,50.
0.010 <= valueMonto máximo, en pesos, con hasta 2 decimales. Igual a minAmount busca un valor exacto, centavos incluidos.
0.010 <= valueBusca en «pagado a» y en las notas.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/expenses"{ "object": "list", "data": [ { "object": "expense", "id": "cmtk9xq2z0041suw1n7mmb0af", "amount": 120000, "currency": "COP", "paidTo": "Harina La Espiga", "occurredAt": "2026-09-03T14:10:00.000Z", "createdAt": "2026-09-03T14:12:44.008Z", "accountLabel": "Bancolombia *4643", "paymentMethod": "TRANSFER", "notes": "Pedido semanal", "source": "PANEL", "category": { "id": "cmt7xbg1a0009q3w1v8s0nn1c", "name": "Insumos", "emoji": "🌾" }, "branch": { "id": "cmt7xbfrj0002q3w1iq4ysatr", "name": "Principal" }, "createdBy": { "id": "cmt8u1p9r00035pw1kq0v2xdc", "name": "Laura Gómez", "phone": null } } ], "hasMore": false, "nextCursor": null}