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. Formato vk_live_… (o vk_test_… fuera de producción).
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 (plan Multi); 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 enteros.
Monto máximo, en pesos enteros.
Cuenta 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": 900000, "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"}