Get Banks by Currency

Get banks available for a specific fiat currency.

Returns all banks that support a given fiat currency. Use this to populate a bank selection dropdown for your users.

Endpoint

GET /v1/banks/:currency

Authentication

Accepts either a merchant API key or a business-user JWT.

Header	Value
Authorization	<api_key> or Bearer <jwt>

Path parameters

Parameter	Type	Description
currency	string	Fiat currency code (e.g., NGN, KES, GHS)

Example request

cURL

curl -X GET https://ramp-api.ivorypay.io/api/v1/banks/NGN \
  -H "Authorization: your_api_key"

Node.js

Python

Go

Example response

{
  "success": true,
  "message": "Query successful",
  "data": [
    {
      "bankName": "Access Bank",
      "bankCode": "044"
    },
    {
      "bankName": "GTBank",
      "bankCode": "058"
    },
    {
      "bankName": "Zenith Bank",
      "bankCode": "057"
    }
  ]
}

Response fields

Field	Type	Description
bankName	string	Display name of the bank
bankCode	string	Bank code (used in API requests like off-ramp)

Note: unlike the List All Banks endpoint, this currency-scoped endpoint does not include bankId in its response — only bankCode and bankName.

The list of available banks varies by currency. Always fetch the bank list for the specific currency your user will transact in.