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

# List All Supported Banks — GET /banks?country_code=NG

> Retrieve the full list of banks supported by Paylink for a given country, including the bank name and code required for transfers and refunds.

Returns all banks supported by Paylink in a given country. Each bank record includes a human-readable name and a machine-readable code. Use these codes when initializing transfers (`destination_bank_code`), issuing refunds (`bank_code`), or resolving account details.

<Tip>
  Cache the bank list in your application and refresh it periodically rather than calling this endpoint on every transaction. The list changes infrequently.
</Tip>

```http theme={null}
GET https://sandbox.lyseis-pay.com/banks
```

<Note>
  This endpoint does not require authentication headers. It is publicly accessible.
</Note>

## Query parameters

<ParamField query="country_code" type="string" default="NG">
  Uppercase ISO 3166-1 alpha-2 country code specifying which country's banks to return. Defaults to `NG` (Nigeria).
</ParamField>

## Example request

```http theme={null}
GET https://sandbox.lyseis-pay.com/banks?country_code=NG
```

## Example response

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "bank_name": "Access Bank",
      "bank_code": "044"
    },
    {
      "bank_name": "Example Bank",
      "bank_code": "058"
    },
    {
      "bank_name": "First Bank of Nigeria",
      "bank_code": "011"
    },
    {
      "bank_name": "Guaranty Trust Bank",
      "bank_code": "058"
    },
    {
      "bank_name": "Zenith Bank",
      "bank_code": "057"
    }
  ]
}
```

## Response fields

<ResponseField name="status" type="string">
  Request outcome. `success` indicates the list was returned successfully.
</ResponseField>

<ResponseField name="data" type="array">
  Array of bank objects supported in the requested country.

  <Expandable title="Bank object fields">
    <ResponseField name="bank_name" type="string">
      The full display name of the bank.
    </ResponseField>

    <ResponseField name="bank_code" type="string">
      The bank code to use in transfer and refund requests.
    </ResponseField>
  </Expandable>
</ResponseField>

## Where to use bank codes

| Endpoint                         | Field                   |
| -------------------------------- | ----------------------- |
| `POST /disbursements/initialize` | `destination_bank_code` |
| `POST /refunds/initialize`       | `bank_code`             |
| `POST /banks/resolve`            | `bank`                  |
| `POST /direct-debits/mandates`   | `bank_code`             |