---
title: "Get wallet details"
method: GET
path: "/wallet"
tags: ["Wallet"]
---

# Get wallet details

`GET /wallet`

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

## Query parameters

- `walletId` string, uuid
- `currency` 'NGN' | 'KES' | 'BTC' | 'USD' | 'USDT'

## Response `200`

Wallet response

- object
  - `status` string, string
  - `data` Wallet[]
    - `id` string, string — The unique identifier for the wallet
    - `accountId` string, uuid — The unique identifier for the account related to the wallet
    - `currency` 'NGN' | 'KES' | 'BTC' | 'ZAR' | 'GHS' | 'USDT', string
    - `balance` number — The balance of the wallet in its lowest denomination

## Other responses

- `400` — Unexpected error

## Changes

- **2026-08-20** `842376cab855` — 1 warning, 1 info
  - added the new `USDT` enum value to the `data/items/currency` response property for the response status `200`
  - added the new enum value `USDT` to the `query` request parameter `currency`
- **2026-04-01** `b1804285e901` — 1 warning
  - added the new `GHS` enum value to the `data/items/currency` response property for the response status `200`
- **2025-02-01** `6bb4d2ebd1b9` — 1 warning, 1 info
  - added the new `ZAR` enum value to the `data/items/currency` response property for the response status `200`
  - removed the `USD` enum value from the `data/items/currency` response property for the response status `200`
- **2024-06-15** `917bda1918db` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stealthmoney/apis/mavapay-api/changes/wallet/get.md)

---

[API](https://skmtc.dev/stealthmoney/apis/mavapay-api.md) · [All operations](https://skmtc.dev/stealthmoney/apis/mavapay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stealthmoney/mavapay-api/revisions/842376cab855/schema)