# Banking

## List Banks By Currency

Return the supported banking institutions for the requested settlement currency.

### Endpoint

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

### Authorization

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

### Path Parameters

- **currency**: 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 "
```

## How is this guide?
Good / Bad

Last updated on 5/27/2026.