Wallet

Get wallet details

Changed on Aug 20, 2026

Returns the wallet details for a given wallet ID or all wallets

get/wallet

Request

Base URL
https://staging.api.mavapay.co/api/v1
Auth
- API key in header X-API-KEY
- or HTTP bearer
TypeScript
https://skmtc.dev/stealthmoney/apis/mavapay-api/docs/wallet/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

walletIdstring uuid

The wallet ID to get the details for (optional)

currency'NGN' | 'KES' | 'BTC' | 'USD' | 'USDT'

The currency to get the details for (optional)

Response

Wallet response

statusstring string

Example response

{
  "status": "ok",
  "data": [
    {
      "id": "d1614a76-9c7f-4111-98a7-43199f307e5b",
      "accountId": "d1614a76-9c7f-4111-98a7-43199f307e5b",
      "balance": 1000
    }
  ]
}

Changes

Aug 20, 2026842376cab855 Revision changes
- warning
  added the new USDT enum value to the // response property for the response status
- info
  added the new enum value USDT to the query request parameter currency
Apr 1, 2026b1804285e901 Revision changes
- warning
  added the new GHS enum value to the // response property for the response status

Operation history (4 revisions)