Bank List
Retrieve all supported banks for NGN payout transfers
Bank List
Returns the banks supported for payout transfers. Use the bank_code field from this response as the bankCode when verifying an account or initiating a transfer.
Headers
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer sk_test_... (test) or Bearer sk_live_... (live) — see Authentication |
List Banks
GET /api/v1/transfers/banksQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
currency | string | No | Currency code. Defaults to NGN. |
Example Request
curl -X GET "https://api.uveruspayments.com/api/v1/transfers/banks?currency=NGN" \
-H "Authorization: Bearer sk_live_..."Example Response
[
{ "bank_code": "044", "bank_name": "Access Bank" },
{ "bank_code": "058", "bank_name": "Guaranty Trust Bank" },
{ "bank_code": "057", "bank_name": "Zenith Bank" }
]Note
The live list is fetched from your payment provider in real time — the fields above are the ones your integration can rely on, but the exact set of banks and any extra fields returned depend on the provider. In test mode, this returns a short fixed list of simulated banks instead of the full live list.
Response Fields
| Field | Type | Description |
|---|---|---|
bank_name | string | Full bank name |
bank_code | string | Bank code to use in the bankCode field of transfers |