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

{
  "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

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

401 application/json

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

403 application/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

{
  "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

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

cURL Example

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.