---
title: "List banks"
method: GET
path: "/v1/transfer/banks"
tags: ["Transfers"]
---

# List banks

`GET /v1/transfer/banks`

## Request

- Base URL: `https://api.kyshi.co`
- URL: `https://api.kyshi.co/v1/transfer/banks`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/docs/v1/transfer/banks/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the banks available for payouts in the requested currency. Bank codes are not stable across providers or markets, so fetch this list rather than hardcoding it.

## Query parameters

- `currency` string

## Other responses

- `400`: Missing or invalid request parameter.
- `401`: No valid API key provided.
- `403`: The API key lacks permission for this request.
- `404`: Resource not found. A 404 on an object you just created is usually a test/live mode mismatch.
- `422`: Business rule failure, such as an unsupported currency or insufficient balance.
- `500`: Something went wrong on Kyshi’s end.

## Changes

- **2026-11-03** `4aed77604588`: 4 breaking, 4 warning, 8 info
  - removed the enum value `GHS` from the `query` request parameter `currency`
  - removed the enum value `KES` from the `query` request parameter `currency`
  - removed the enum value `NGN` from the `query` request parameter `currency`
  - the response's body type changed from `object` to no type for status `200`
  - …12 more

[Operation history](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/changes/v1/transfer/banks/get.md)

---

[API](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api.md) - [All operations](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kyshi/apis/kyshi-mor-public-api/revisions/4aed77604588?raw)
