List All Banks

Retrieve all supported banks.

Returns a list of all banks supported by IvoryPay across all currencies.

Endpoint

GET /v1/banks

Authentication

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

Header

Value

Authorization

<api_key> or Bearer <jwt>

Example request

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

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

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

package main

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

func main() {
	req, _ := http.NewRequest("GET", "https://ramp-api.ivorypay.io/api/v1/banks", 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",
      "bankId": "uuid-here",
      "bankCode": "044"
    },
    {
      "bankName": "GTBank",
      "bankId": "uuid-here",
      "bankCode": "058"
    },
    {
      "bankName": "First Bank",
      "bankId": "uuid-here",
      "bankCode": "011"
    }
  ]
}

Response fields

Field

Type

Description

bankName

string

Display name of the bank

bankId

string

IvoryPay's bank UUID

bankCode

string

Bank code (used in API requests like off-ramp)

PreviousGet Off-Ramp Exchange Rate NextGet Banks by Currency

Last updated 21 days ago