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, ZAR)

Example request

cURL

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

Node.js

const response = await fetch("https://ramp-api.ivorypay.io/api/v1/banks/NGN", {
  method: "GET",
  headers: {
    "Authorization": "your_api_key",
  },
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
    "https://ramp-api.ivorypay.io/api/v1/banks/NGN",
    headers={
        "Authorization": "your_api_key",
    },
)

print(response.json())

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://ramp-api.ivorypay.io/api/v1/banks/NGN", nil)
	req.Header.Set("Authorization", "your_api_key")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

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.