Skip to main content
GET
https://api-staging.fossapay.com
/
v1
/
transfers
/
fiat
/
banks
Get Supported Banks
curl --request GET \
  --url https://api-staging.fossapay.com/v1/transfers/fiat/banks \
  --header 'x-api-key: <x-api-key>'
{
  "status": true,
  "statusCode": 200,
  "message": "Supported banks retrieved successfully",
  "data": [
    {
      "bankname": "9 payment service Bank",
      "bankcode": "120001"
    },
    {
      "bankname": "AB MICROFINANCE BANK",
      "bankcode": "090270"
    },
    {
      "bankname": "ABBEY MORTGAGE BANK",
      "bankcode": "090304"
    },
    {
      "bankname": "ACCESS BANK",
      "bankcode": "044"
    },
    {
      "bankname": "ACCESS BANK (DIAMOND)",
      "bankcode": "063"
    }
  ]
}

​
Request

​
x-api-key
string
required
API Key for authentication

​
Request Example

curl -X GET https://api-staging.fossapay.com/v1/transfers/fiat/banks \
  -H "x-api-key: your_api_key_here"

const banks = await client.fiatTransfers.getSupportedBanks();

​
Response

{
  "status": true,
  "statusCode": 200,
  "message": "Supported banks retrieved successfully",
  "data": [
    {
      "bankname": "9 payment service Bank",
      "bankcode": "120001"
    },
    {
      "bankname": "AB MICROFINANCE BANK",
      "bankcode": "090270"
    },
    {
      "bankname": "ABBEY MORTGAGE BANK",
      "bankcode": "090304"
    },
    {
      "bankname": "ACCESS BANK",
      "bankcode": "044"
    },
    {
      "bankname": "ACCESS BANK (DIAMOND)",
      "bankcode": "063"
    }
  ]
}

{
  "status": false,
  "statusCode": 400,
  "message": "Bad request",
  "error": "Invalid API key"
}

{
  "status": false,
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Failed to retrieve supported banks"
}