# Banking

## List Banks By Currency

Return the supported banking institutions for the requested settlement currency.

### API Endpoint

`GET`  `/api/v1/banking/banks/{currency}`

### Authorization

- **Type**: BearerAuth  
- **Header**: `Authorization: Bearer <token>`

### Path Parameters

- **currency** (string): Settlement currency to filter the supported bank list

### Response Body

#### 200  application/json

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Banks fetched successfully.",
  "statusCode": 200,
  "data": [
    {
      "bankName": "Access Bank Plc",
      "bankCode": "044"
    }
  ]
}
```

#### 400  application/json

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Currency not supported",
  "statusCode": 400
}
```

#### 401  application/json

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Invalid API key",
  "statusCode": 401
}
```

#### 403  application/json

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Incorrect PIN or access denied.",
  "statusCode": 403
}
```

#### 500  application/json

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "An error occurred while processing your request.",
  "statusCode": 500
}
```

#### 503  application/json

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Banking service is temporarily unavailable.",
  "statusCode": 503
}
```

### cURL Example

```bash
curl -X GET "https://atlas.tryduplo.com/api/v1/banking/banks/NGN" \
  -H "Authorization: Bearer "
```