Wallets
Read your balance in every currency your business holds.
Your business has one wallet per enabled currency, plus a primary wallet. Payouts debit a wallet and settled collections credit one. To see the movements behind a balance, use Transactions.
List wallets
GET /wallets returns every wallet, sorted by currency code. Requires the wallet.view scope. It takes no parameters.
curl https://business-api.migrapay.com/v1/api/wallets \
-H "Authorization: Bearer $MIGRAPAY_API_KEY"{
"status": "success",
"message": "Wallets retrieved successfully.",
"data": {
"wallets": [
{
"id": "3f6c2a10-8b1d-4e5f-9a7c-000000000001",
"businessId": "b7e4d2c1-5a3f-4c8e-8d2b-000000000001",
"currency": "CAD",
"country": "CA",
"balance": 12584.5,
"ledgerBalance": 12584.5,
"primary": true,
"enabled": true,
"status": "active",
"createdAt": "2026-08-01T10:15:30.000Z",
"updatedAt": "2026-08-12T16:02:11.000Z"
},
{
"id": "3f6c2a10-8b1d-4e5f-9a7c-000000000002",
"businessId": "b7e4d2c1-5a3f-4c8e-8d2b-000000000001",
"currency": "NGN",
"country": "NG",
"balance": 1850000,
"ledgerBalance": 1850000,
"primary": false,
"enabled": true,
"status": "active",
"createdAt": "2026-08-01T10:15:30.000Z",
"updatedAt": "2026-08-10T09:44:05.000Z"
}
]
}
}The wallet object
Prop
Type
Amounts
All amounts in the API are numbers in major units: 12584.5 is 12,584.50 CAD.