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
/v1/accountsRequiere 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
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?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
| HTTP | code | Cuándo ocurre |
|---|---|---|
| 404 | resource_missing | El link_id no existe en el modo de la llave. |
| 400 | invalid_limit | limit no es un entero entre 1 y 100. |
| 400 | invalid_cursor | starting_after no es el id de una cuenta de esta lista. |
Obtener una cuenta
/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
| HTTP | code | Cuándo ocurre |
|---|---|---|
| 404 | resource_missing | No existe una cuenta con ese id en tu organización y en el modo de la llave. |