Saltar al contenido

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}/movements

Requiere 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 a since.
limitinteger
Cantidad de elementos por página, entre 1 y 100. Por defecto 50.
starting_afterstring
Cursor: el id del ú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

HTTPcodeCuándo ocurre
404resource_missingNo existe la cuenta en el modo de la llave.
400invalid_datesince o until no tienen el formato AAAA-MM-DD.
400invalid_date_rangesince es posterior a until.
400invalid_limitlimit no es un entero entre 1 y 100.
400invalid_cursorstarting_after no es el id de un movimiento de esta cuenta.