Skip to main content
GET
/
banks
List Banks
curl --request GET \
  --url https://api.rolla.xyz/api/v1/external/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 all Nigerian banks supported on the platform. Use the bankCode from this response when performing account lookups.

​
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" }
    ]
  }
}
The bank list is cached and updated periodically. Store the list locally if you need to display bank options frequently.

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