Skip to main content
Returns all banks supported for account inquiry and fund transfers. Each bank entry includes a name and a bankCode required by other transfer endpoints.

​
Authentication

x-api-key: your_api_key
x-api-secret: your_api_secret

​
Endpoint

GET https://api.hyparrow.com/api/v1/transfers/banks

​
Response

​
success
boolean
true when the request succeeds.
​
data
array
Array of bank objects.

​
Examples

curl -X GET https://api.hyparrow.com/api/v1/transfers/banks \
  -H "x-api-key: your_api_key" \
  -H "x-api-secret: your_api_secret"

​
Success response

{
  "success": true,
  "data": [
    { "name": "Access Bank", "bankCode": "044" },
    { "name": "First Bank of Nigeria", "bankCode": "011" },
    { "name": "Guaranty Trust Bank", "bankCode": "058" },
    { "name": "United Bank for Africa", "bankCode": "033" },
    { "name": "Zenith Bank", "bankCode": "057" },
    { "name": "Kuda Bank", "bankCode": "50211" },
    { "name": "OPay", "bankCode": "999992" }
  ]
}

​
Error response

{
  "success": false,
  "error": "Failed to get banks: upstream service unavailable"
}
Bank data is served from a cache and refreshed periodically. If you need the latest list, retry after a few minutes if data appears stale.