Skip to main content
GET
/
beneficiaries
/
nigerian-banks
List Nigerian Banks
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/beneficiaries/nigerian-banks \
  --header 'X-API-Key: <api-key>'
{
  "status": 200,
  "success": true,
  "message": "Banks retrieved successfully",
  "data": {
    "banks": [
      {
        "bankName": "Access Bank",
        "bankCode": "000014"
      }
    ]
  }
}
Retrieve a list of Nigerian banks for use when creating NGN beneficiaries. Returns the same data as the /banks endpoint.

​
Example Request

curl -X GET "https://api.rolla.xyz/api/v1/external/beneficiaries/nigerian-banks" \
  -H "X-API-Key: your_api_key_here"

​
Example Response

{
  "status": 200,
  "success": true,
  "message": "Banks retrieved successfully",
  "data": {
    "banks": [
      { "bankName": "Access Bank", "bankCode": "000014" },
      { "bankName": "GTBank", "bankCode": "000013" },
      { "bankName": "Zenith Bank", "bankCode": "000015" }
    ]
  }
}
Use the bankCode from this response when creating NGN beneficiaries or performing account lookups.

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Response

Banks retrieved successfully

​
status
integer
Example:

200

​
success
boolean
Example:

true

​
message
string
Example:

"Banks retrieved successfully"

​
data
object