Endpoints

Documentación completa de los endpoints disponibles en la API de Información de Cuentas (AIS). Todos los endpoints requieren autenticación OAuth 2.0.

Base URL:https://api.banrural.com.gt/v1Sandbox: https://sandbox.api.banrural.com.gt/v1

Descripción

Obtiene una lista de todas las cuentas bancarias asociadas al cliente autenticado. Retorna información básica como tipo de cuenta, número enmascarado, moneda y saldo disponible.

Respuestas

200Lista de cuentas obtenida exitosamente

401Token de acceso inválido o expirado

403Sin permisos para acceder a las cuentas

Ejemplo de Request

curl -X GET "https://api.banrural.com.gt/v1/accounts" \
  -H "Authorization: Bearer {access_token}" \
  -H "Accept: application/json"

Ejemplo de Response (200 OK)

[
  {
    "accountId": "c7b5b8a0-5b9a-4b0e-8c3b-3e6a1b2a3f4d",
    "accountType": "AHORRO",
    "accountNumber": "XXXX-XXXX-XX-XXXXXX1234",
    "currency": "GTQ",
    "balance": 12550.75
  },
  {
    "accountId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "accountType": "MONETARIA",
    "accountNumber": "XXXX-XXXX-XX-XXXXXX5678",
    "currency": "USD",
    "balance": 2500.00
  }
]