Skip to main content
Use this endpoint to retrieve banks supported by Pasteaza for bank transfer disbursements. You need a bank code when you resolve an account number or create a bank transfer.
Cache the bank list in your application and refresh it periodically. Avoid calling this endpoint before every transfer.

​
Endpoint

GET /v1/banks

​
Headers

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json

​
Example request

curl https://api.oyapasteaza.com/v1/banks \
  -X GET \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

​
Successful response

{
  "status": true,
  "message": "Banks retrieved successfully.",
  "data": [
    {
      "code": "044",
      "name": "Access Bank Plc"
    },
    {
      "code": "011",
      "name": "First Bank of Nigeria"
    },
    {
      "code": "058",
      "name": "Guaranty Trust Bank"
    },
    {
      "code": "232",
      "name": "Sterling Bank"
    }
  ]
}

​
Response fields

FieldTypeDescription
codestringThe bank code to use when resolving an account or creating a transfer.
namestringThe display name of the supported bank.

​
How to use bank codes

1

Fetch supported banks

Retrieve the list of banks and store the bank code and name values.
2

Let the customer choose a bank

Show the bank names in your payout or transfer form.
3

Resolve the account

Send the selected bank code with the account number to confirm the account holder’s name.
4

Create the transfer

Use the verified account details to create a bank transfer.

​
Notes

  • The bank list may change as institutions are added or removed.
  • Store the bank code, not only the bank name.
  • Refresh cached banks periodically to keep your transfer form up to date.
  • Use the same bank code when resolving accounts and creating transfers.

​
Next steps

Resolve account

Confirm an account name before creating a transfer.

Create transfer

Send money to a verified bank account.