Listar ingresos
Lista los pagos del negocio, del más reciente al más antiguo, paginada por cursor.
Acepta los mismos filtros que el panel: si el reporte que descarga el dueño y lo que lee tu integración salieran de filtros distintos, dirían cosas distintas del mismo mes.
Autorización
apiKey incomes.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: incomes.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.
Desde esta fecha. Una fecha pelada (2026-09-01) es un día de calendario colombiano, no UTC.
Hasta esta fecha, inclusive.
Estado del pago. Repetible. Por defecto se ocultan los estados sospechosos (duplicado, no encontrado), que viven en su propia página.
Por dónde entró el pago. 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 <= valueCuenta de recaudo. Repetible.
Busca en nombre del cliente y en la referencia.
Orden del listado.
"recent"Uno de
- "recent"
- "oldest"
- "amount_desc"
- "amount_asc"
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/incomes"{ "object": "list", "data": [ { "object": "income", "id": "cmtmf1k8m006faqw1lh27ozcr", "amount": 45000, "currency": "COP", "status": "VERIFIED", "origin": "WHATSAPP", "occurredAt": "2026-09-04T20:04:05.000Z", "createdAt": "2026-09-04T20:04:12.311Z", "verifiedAt": "2026-09-04T20:05:41.902Z", "reference": "M1A2B3C4", "customerName": "Juan Pérez", "bankLabel": "Bancolombia", "accountLabel": "Nequi *4821", "duplicateOfId": null, "branch": { "id": "cmt7xbfrj0002q3w1iq4ysatr", "name": "Principal" }, "confirmedBy": { "id": "cmt8u1p9r00035pw1kq0v2xdc", "name": "Laura Gómez", "phone": "+573001112233" }, "attachments": [ { "id": "cmtmf1kax006haqw1r3vv9y2p", "contentType": "image/jpeg", "originalName": "comprobante.jpg", "size": 84213 } ], "bankChannels": [ "EMAIL" ] }, { "object": "income", "id": "cmtkc0rif005ysuw1mbeef235", "amount": 146357.19, "currency": "COP", "status": "PENDING", "origin": "BANK", "occurredAt": "2026-09-04T03:39:59.000Z", "createdAt": "2026-09-04T03:50:20.854Z", "verifiedAt": null, "reference": null, "customerName": null, "bankLabel": "Davivienda", "accountLabel": "*4643", "duplicateOfId": null, "branch": { "id": "cmt7xbfrj0002q3w1iq4ysatr", "name": "Principal" }, "confirmedBy": { "id": null, "name": null, "phone": null }, "attachments": [], "bankChannels": [ "EMAIL" ] } ], "hasMore": true, "nextCursor": "cmtkc0rif005ysuw1mbeef235"}