> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oyapasteaza.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List banks

> Retrieve supported banks for bank transfer disbursements.

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.

<Info>
  Cache the bank list in your application and refresh it periodically. Avoid calling this endpoint before every transfer.
</Info>

## Endpoint

```http theme={null}
GET /v1/banks
```

## Headers

```http theme={null}
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Content-Type: application/json
```

## Example request

```bash theme={null}
curl https://api.oyapasteaza.com/v1/banks \
  -X GET \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"
```

## Successful response

```json theme={null}
{
  "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

| Field  | Type   | Description                                                            |
| ------ | ------ | ---------------------------------------------------------------------- |
| `code` | string | The bank code to use when resolving an account or creating a transfer. |
| `name` | string | The display name of the supported bank.                                |

## How to use bank codes

<Steps>
  <Step title="Fetch supported banks">
    Retrieve the list of banks and store the bank `code` and `name` values.
  </Step>

  <Step title="Let the customer choose a bank">
    Show the bank names in your payout or transfer form.
  </Step>

  <Step title="Resolve the account">
    Send the selected bank `code` with the account number to confirm the account holder's name.
  </Step>

  <Step title="Create the transfer">
    Use the verified account details to create a bank transfer.
  </Step>
</Steps>

## 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

<CardGroup cols={2}>
  <Card title="Resolve account" icon="magnifying-glass" href="/disbursements/bank-transfer/resolve-account">
    Confirm an account name before creating a transfer.
  </Card>

  <Card title="Create transfer" icon="arrow-up-from-line" href="/disbursements/bank-transfer/create-transfer">
    Send money to a verified bank account.
  </Card>
</CardGroup>