List All Banks

Retrieve all supported banks.

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

Endpoint

GET /v1/banks

Authentication

Header	Value
x-api-key	Your API key

Example request

cURL

curl -X GET https://ramp-api.ivorypay.io/api/v1/banks \
  -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": "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 and sell)