Referencia de API
Movimientos
Los movimientos son los abonos y cargos de una cuenta. Cada uno trae la glosa original del banco y, cuando el banco la informa, la contraparte con nombre y RUT y el número de operación. Campos en Objetos › Movement.
Listar movimientos
GET
/v1/accounts/{id}/movementsRequiere llave secret. URL completa: https://api.banky.cl/v1/accounts/{id}/movements
Devuelve los movimientos ordenados por fecha contable, del más nuevo al más antiguo. Sin filtros, entrega todo el historial guardado: en la primera conexión leemos los últimos 90 días y desde ahí acumulamos.
Parámetros de ruta
idstringobligatorio- Id de la cuenta, por ejemplo
acc_3f9a1c0e5b7d2468.
Parámetros de consulta
sincestring (date)- Fecha contable desde (inclusive), en formato
AAAA-MM-DD. untilstring (date)- Fecha contable hasta (inclusive), en formato
AAAA-MM-DD. No puede ser anterior asince. limitinteger- Cantidad de elementos por página, entre 1 y 100. Por defecto 50.
starting_afterstring- Cursor: el
iddel último elemento de la página anterior. Devuelve los elementos que vienen después.
Ejemplo de petición
curl "https://api.banky.cl/v1/accounts/acc_3f9a1c0e5b7d2468/movements?since=2026-11-01&until=2026-11-30&limit=3" \
-H "Authorization: Bearer $BANKY_SECRET_KEY"Respuesta
application/json
200{
"object": "list",
"data": [
{
"id": "mov_e41b9c07a2d85f36",
"object": "movement",
"account_id": "acc_3f9a1c0e5b7d2468",
"amount": 1315000,
"currency": "CLP",
"type": "inflow",
"description": "Pago de factura de Constructora Valle Central SpA",
"bank_description": "TRASPASO DE: CONSTRUCTORA VALLE CENTRAL SPA",
"post_date": "2026-11-18",
"transaction_date": "2026-11-18",
"counterparty": {
"name": "Constructora Valle Central SpA",
"id": "76287005-3"
},
"reference_id": "479249273"
},
{
"id": "mov_d2a8f5c1e9b04763",
"object": "movement",
"account_id": "acc_3f9a1c0e5b7d2468",
"amount": 375900,
"currency": "CLP",
"type": "inflow",
"description": "Pago de factura de Constructora Valle Central SpA",
"bank_description": "TRASPASO DE: CONSTRUCTORA VALLE CENTRAL SPA",
"post_date": "2026-11-13",
"transaction_date": "2026-11-13",
"counterparty": {
"name": "Constructora Valle Central SpA",
"id": "76287005-3"
},
"reference_id": "214218054"
},
{
"id": "mov_c07f3e9a15b2d846",
"object": "movement",
"account_id": "acc_3f9a1c0e5b7d2468",
"amount": -412000,
"currency": "CLP",
"type": "outflow",
"description": "Pago de impuestos mensuales (F29)",
"bank_description": "PAGO EN LINEA TESORERIA",
"post_date": "2026-11-12",
"transaction_date": "2026-11-12",
"counterparty": {
"name": null,
"id": null
},
"reference_id": null
}
],
"has_more": true
}Errores propios de este endpoint
| HTTP | code | Cuándo ocurre |
|---|---|---|
| 404 | resource_missing | No existe la cuenta en el modo de la llave. |
| 400 | invalid_date | since o until no tienen el formato AAAA-MM-DD. |
| 400 | invalid_date_range | since es posterior a until. |
| 400 | invalid_limit | limit no es un entero entre 1 y 100. |
| 400 | invalid_cursor | starting_after no es el id de un movimiento de esta cuenta. |