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

Header	Value
x-api-key	Your API key

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 "x-api-key: your_api_key"

Node.js

Python

Go

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Query successful",
  "data": [
    {
      "bankName": "Access Bank",
      "bankId": "uuid-here",
      "bankCode": "044"
    },
    {
      "bankName": "GTBank",
      "bankId": "uuid-here",
      "bankCode": "058"
    },
    {
      "bankName": "Zenith Bank",
      "bankId": "uuid-here",
      "bankCode": "057"
    }
  ]
}

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