# List Banks

**GET** `/banks`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

To retrieve a list of banks supported by TripleA so far.

## Authorization

- oauth2 (http, bearer)

## Query parameters

- `page` (integer)
  Specify the page number
- `per_page` (integer)
  Specify the number of items per page
- `name` (string)
  name of bank to search
- `country_code` (string)
  ISO-3166-1 alpha3 country code
- `currency` (string)
  currency of the bank
- `network` (string)
  network for the currency and country
- `id` (string)
  id of the bank

## Responses

### 200

OK

- `id` (string<uuid>)
  Bank UUID
- `type` ("bank")
  Bank UUID
- `name` (string)
  Bank name
- `country_code` (string<iso-3166-1-alpha3>)
  Bank operating country
- `currency` (string<iso-4217>)
  Currency
- `reference_code` (string)
  A unique reference to the bank
- `extra_data` (object)
  A unique reference to the bank
  - `city` (string)
  - `state` (string)
  - `branch` (string)
  - `district` (string)
  - `branch_code` (string)
- `created_at` (string<date-time>)
- `updated_at` (string<date-time>)

Example:

```json
[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "bank",
    "name": "Citibank",
    "country_code": "USA",
    "currency": "USD",
    "reference_code": "string",
    "extra_data": {
      "city": "string",
      "state": "string",
      "branch": "string",
      "district": "string",
      "branch_code": "string"
    },
    "created_at": "1970-01-01T00:00:00.000Z",
    "updated_at": "1970-01-01T00:00:00.000Z"
  }
]
```