Skip to main content
GET
/
api
/
v1
/
banks
List Banks
curl --request GET \
  --url https://api.usezentra.com/api/v1/banks \
  --header 'Authorization: Bearer <token>'

​
List Banks

Fetch the currently supported banks for payout creation and related bank-directory lookups.

​
Endpoint

GET /api/v1/banks

​
Query Parameters

​
country
string
default:"NG"
Country code. The current reviewed default is NG.

​
Example Request

curl "https://api.usezentra.com/api/v1/banks?country=NG" \
  -H "Authorization: Bearer YOUR_SECRET_KEY"

​
Example Response

{
  "status": "success",
  "data": [
    { "code": "058", "name": "Guaranty Trust Bank" },
    { "code": "044", "name": "Access Bank" },
    { "code": "033", "name": "United Bank for Africa" }
  ]
}

​
Usage Notes

  • Cache bank codes in your application and refresh them periodically.
  • Pair this endpoint with transfer creation and any tenant-approved beneficiary verification workflow.
  • The reviewed public gateway exposes bank-directory lookup on /api/v1/banks, not under /transfers/banks.

​
Next Steps

Create Transfer

Initiate a bank transfer

Resolve Account

Compatibility note for beneficiary lookup flows