Saltar al contenido

Referencia de API

Cuentas

Cada link tiene una o más cuentas: corriente, vista, ahorro, tarjeta o línea de crédito. El saldo se actualiza en cada sincronización. Campos en Objetos › Account.

Listar cuentas

GET/v1/accounts

Requiere llave secret. URL completa: https://api.banky.cl/v1/accounts

Ordenadas de la más reciente a la más antigua según cuándo las encontramos por primera vez.

Parámetros de consulta

link_idstring
Solo las cuentas de este link. Sin este parámetro, devuelve las cuentas de todos los links del modo de la llave.
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?link_id=link_9f2c41ab7e05d318" \
  -H "Authorization: Bearer $BANKY_SECRET_KEY"

Respuesta

application/json

200
{
  "object": "list",
  "data": [
    {
      "id": "acc_b84e27d1f05c9a63",
      "object": "account",
      "link_id": "link_9f2c41ab7e05d318",
      "number": "0081785975",
      "name": "Línea de Crédito",
      "type": "line_of_credit",
      "currency": "CLP",
      "balance": {
        "available": -96250,
        "current": -96250
      },
      "refreshed_at": "2026-11-18T14:02:11.204Z"
    },
    {
      "id": "acc_3f9a1c0e5b7d2468",
      "object": "account",
      "link_id": "link_9f2c41ab7e05d318",
      "number": "0012785975",
      "name": "Cuenta Corriente",
      "type": "checking_account",
      "currency": "CLP",
      "balance": {
        "available": 26593700,
        "current": 26638700
      },
      "refreshed_at": "2026-11-18T14:02:11.204Z"
    }
  ],
  "has_more": false
}

Errores propios de este endpoint

HTTPcodeCuándo ocurre
404resource_missingEl link_id no existe en el modo de la llave.
400invalid_limitlimit no es un entero entre 1 y 100.
400invalid_cursorstarting_after no es el id de una cuenta de esta lista.

Obtener una cuenta

GET/v1/accounts/{id}

Requiere llave secret. URL completa: https://api.banky.cl/v1/accounts/{id}

balance.available es el saldo disponible y balance.current el contable, ambos en pesos enteros. refreshed_at indica cuándo se leyó el saldo por última vez.

Parámetros de ruta

idstringobligatorio
Id de la cuenta, por ejemplo acc_3f9a1c0e5b7d2468.

Ejemplo de petición

curl "https://api.banky.cl/v1/accounts/acc_3f9a1c0e5b7d2468" \
  -H "Authorization: Bearer $BANKY_SECRET_KEY"

Respuesta

application/json

200
{
  "id": "acc_3f9a1c0e5b7d2468",
  "object": "account",
  "link_id": "link_9f2c41ab7e05d318",
  "number": "0012785975",
  "name": "Cuenta Corriente",
  "type": "checking_account",
  "currency": "CLP",
  "balance": {
    "available": 26593700,
    "current": 26638700
  },
  "refreshed_at": "2026-11-18T14:02:11.204Z"
}

Errores propios de este endpoint

HTTPcodeCuándo ocurre
404resource_missingNo existe una cuenta con ese id en tu organización y en el modo de la llave.