Skip to main content
GET
https://api-staging.fossapay.com
/
v1
/
wallets
/
{wallet_id}
/
balance
Get Wallet Balance
curl --request GET \
  --url https://api-staging.fossapay.com/v1/wallets/{wallet_id}/balance
{
  "status": "success",
  "data": {
    "wallet_id": "wal_abc123",
    "balances": [
      {
        "currency": "NGN",
        "available_balance": 150000,
        "ledger_balance": 150000,
        "pending_balance": 0
      },
      {
        "currency": "USDT",
        "available_balance": 100.50,
        "ledger_balance": 100.50,
        "pending_balance": 0
      }
    ]
  }
}

​
Path Parameters

​
wallet_id
string
required
The unique identifier of the wallet

​
Query Parameters

​
currency
string
Filter by specific currency (optional)

​
Request Example

curl "https://api-staging.fossapay.com/v1/wallets/wal_abc123/balance?currency=NGN" \
  -H "Authorization: Bearer fp_live_sk_xxxxxxxx"

const balance = await client.wallets.getBalance('wal_abc123', {
  currency: 'NGN'
});

​
Response

{
  "status": "success",
  "data": {
    "wallet_id": "wal_abc123",
    "balances": [
      {
        "currency": "NGN",
        "available_balance": 150000,
        "ledger_balance": 150000,
        "pending_balance": 0
      },
      {
        "currency": "USDT",
        "available_balance": 100.50,
        "ledger_balance": 100.50,
        "pending_balance": 0
      }
    ]
  }
}