---
title: "Bank Codes"
method: GET
path: "/payaza-account/api/v1/mainaccounts/merchant/banks/{currency_code}"
tags: ["Transfers"]
---

# Bank Codes

`GET /payaza-account/api/v1/mainaccounts/merchant/banks/{currency_code}`

The Bank Codes API is used to retrieve the bank codes available for each country that would be used in the Initiate A Transfer request.

## Path parameters

- `currency_code` string, required

## Response `200`

Payment successful

- BankCodesResponse
  - `message` string — Response message.
  - `status` boolean — Status of the request.
  - `retry_count` integer — Number of retries.
  - `data` object[] — List of available banks.
    - `id` integer — Unique ID of the bank.
    - `name` string — Full name of the bank.
    - `avatar` string — URL to the bank's logo.
    - `code` string — Bank code.
    - `active` boolean — Whether the bank is currently active.
    - `type` string — Type of institution (e.g., mobile_money).
    - `short_name` string — Short name of the bank.
    - `sort_code` string, nullable — Sort code (if applicable).
    - `currency_code` string — Currency supported.
    - `country_code` string — Country code.
    - `block_transaction` boolean — Whether transactions are blocked.

## Other responses

- `400` — Payment failed

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)