Saltar al contenido

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/v1

Todas 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 trae id con prefijo y object con su tipo.
  • Los montos son enteros en pesos chilenos (CLP), sin decimales: 1315000 es $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 son AAAA-MM-DD segú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

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.yaml

Descargar openapi.yaml

Informació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/v1

Respuesta

200
{
  "object": "api",
  "name": "Banky API",
  "version": "v1",
  "documentation": "https://banky.cl/docs"
}