Referencia de API
Referencia de API
La API de Banky es REST: recursos con URLs predecibles, cuerpos y respuestas JSON, y códigos HTTP estándar. Es de solo lectura sobre los datos bancarios; las únicas escrituras crean link tokens, piden sincronizaciones o revocan conexiones.
URL base
URL base
https://api.banky.cl/v1Todas las solicitudes van por HTTPS y se autentican con una llave en el encabezado Authorization (ver Autenticación). La misma URL sirve para live y test: el modo lo decide la llave.
Formato
- Los cuerpos de las solicitudes son JSON (
Content-Type: application/json), de hasta 32 KB. - Los campos van en inglés y en
snake_case. Cada objeto traeidcon prefijo yobjectcon su tipo. - Los montos son enteros en pesos chilenos (
CLP), sin decimales:1315000es $1.315.000. Positivo es abono y negativo es cargo. - Las fechas con hora son ISO 8601 en UTC (
2026-11-18T14:02:11.482Z). Las fechas contables sonAAAA-MM-DDsegún el banco, en hora de Chile. - Los campos sin valor vienen en
null; no se omiten. - Las listas tienen la forma
{ object: "list", data, has_more }(ver Paginación). - Las respuestas llevan
Cache-Control: no-store.
Endpoints
- POST
/v1/link_tokensCrea un link token para abrir el widget. - GET
/v1/linksLista las conexiones. - GET
/v1/links/{id}Obtiene una conexión. - POST
/v1/links/{id}/refreshPide una sincronización. - DELETE
/v1/links/{id}Revoca una conexión. - GET
/v1/accountsLista las cuentas. - GET
/v1/accounts/{id}Obtiene una cuenta. - GET
/v1/accounts/{id}/movementsLista los movimientos de una cuenta. - GET
/v1/institutionsLista los bancos soportados.
Especificación OpenAPI
La API v1 está descrita en OpenAPI 3.1. Puedes importarla en Postman, Insomnia o Bruno, o generar un cliente tipado con tu herramienta favorita.
Terminal
curl -O https://banky.cl/openapi.yamlInformación de la API
GET /v1 no requiere llave y responde con el nombre de la API, la versión y el enlace a esta documentación. Sirve para comprobar la conectividad.
curl https://api.banky.cl/v1Respuesta
200{
"object": "api",
"name": "Banky API",
"version": "v1",
"documentation": "https://banky.cl/docs"
}