List Bank Codes

Retrieves a list of available bank codes for creating fiat accounts via bank transfer in Colombia. Each bank includes its code (used as beneficiary_institution when creating a fiat account) and the allowed counterparty_type values.

This endpoint is only available for accounts operating in Colombia (CO). Requests from accounts in other countries will return a 400 error.

GET /api/v1/banks

List Bank Codes

cURL

curl --request GET \
  --url https://skala-sandbox.ripio.com/api/v1/banks/ \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "code": "1001",
    "name": "Banco de Bogotá",
    "type": [
      "cc",
      "ch"
    ],
    "logo": "https://example.com/logos/banco-bogota.png"
  },
  {
    "code": "1002",
    "name": "Banco Popular",
    "type": [
      "cc"
    ],
    "logo": "https://example.com/logos/banco-popular.png"
  },
  {
    "code": "1003",
    "name": "Bancolombia",
    "type": [
      "cc",
      "ch",
      "dp"
    ],
    "logo": "https://example.com/logos/bancolombia.png"
  }
]

Authorizations

Authorization · string · header · required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Response

200

application/json

A list of available bank codes.

code · string · required

The unique bank code used as the beneficiary_institution value when creating fiat accounts.

name · string · required

The display name of the bank.

type · string[] · required

The allowed counterparty_types for this bank (e.g., cc, ch, dp).

logo · string<url> · required

URL of the bank's logo.