Listar extractos
Los extractos leídos, del más reciente al más viejo, con su progress. Los que se están leyendo no salen aquí: consúltalos por id.
Autorización
apiKey reconciliation.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: reconciliation.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.
Uno de
- "VERIFIED"
- "MISMATCH"
- "UNVERIFIABLE"
Filas por página.
1 <= value <= 10050Cursor: el nextCursor de la página anterior.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/bank-statements"{ "object": "list", "data": [ { "object": "bankStatement", "id": "cmuh8q2r70044x8w1b6n3m1kd", "status": "processed", "fileName": "extracto-bancolombia-septiembre.pdf", "format": "PDF", "kind": "ACCOUNT", "bank": { "key": "bancolombia", "name": "Bancolombia" }, "accountLast4": "8300", "accountType": "AHORROS", "paymentAccount": { "id": "cmt7xbfs10005q3w1u8k2c9va", "provider": "BANCOLOMBIA", "alias": "Ahorros principal", "last4": "8300" }, "currency": "COP", "periodStart": "2026-09-01", "periodEnd": "2026-09-30", "pages": 3, "verdict": "VERIFIED", "balances": { "opening": 1250000, "closing": 3184520.37 }, "totals": { "credits": 4872300, "debits": 2937779.63, "lineCount": 64 }, "bankSummary": { "opening": 1250000, "closing": 3184520.37, "credits": 4872300, "debits": 2937779.63, "gmf": 11751.12, "yields": 412.5, "interest": null, "fees": 14280 }, "difference": { "closingBalance": 0, "credits": 0, "debits": 0 }, "checks": [ { "key": "balance", "label": "Saldo final", "status": "PASS", "expected": 3184520.37, "actual": 3184520.37, "detail": "El saldo inicial más los movimientos da el saldo final del banco." } ], "warnings": [], "hasOriginal": true, "matchedAt": "2026-10-12T21:03:11.000Z", "createdAt": "2026-10-12T21:03:02.000Z", "progress": { "total": 64, "resolved": 51, "pending": 13, "percentResolved": 80 } } ], "hasMore": false, "nextCursor": null}Ver un extracto GET
El extracto leído (resumen completo: cuadre, % resuelto, grupos, lo que solo está en Verifika), leyéndose (`processing`, con `Retry-After`) o fallido (`failed`, con el `error` que habría dado la subida). Una lectura con más de 15 min «procesando» se cortó: pasa a `failed` con `PROCESSING_INTERRUPTED`.
Volver a cruzar POST
Vuelve a cruzar el extracto contra el libro (útil después de registrar pagos que faltaban). Lo resuelto a mano se respeta.