Ask Moov Beta
Generative AI is experimental and can make mistakes.
Guides Use cases API Changelog
  1. API reference
  2. Sources
  3. Wallets

Retrieve a wallet

Get information on a specific wallet (e.g., the available balance). Read our Moov wallets guide to learn more.

To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/wallets.read scope when generating a token.
GET
/accounts/{accountID}/wallets/{walletID}
cURL Go JavaScript 
1
2

curl -X GET "https://api.moov.io/accounts/{accountID}/wallets/{walletID}" \
  -H "Authorization: Bearer {token}" \

1
2
3
4
5
6

mc, _ := moov.NewClient()

var accountID string
var walletID string

mc.GetWallet(ctx, accountID, walletID)

1
2
3

const moov = new Moov(credentialsObject);

moov.wallets.get(accountID, walletID);
200 404 429
Wallets associated with the given account
A Moov wallet to store funds for transfers.
{
  "availableBalance": {
    "currency": "USD",
    "value": 1204,
    "valueDecimal": "12.987654321"
  },
  "walletID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43"
}
Empty response for unauthorized or any other returned http status code.
Request was refused due to rate limiting.

Response headers

Retry-After

number

Path parameters

accountID

string <uuid> required
ID of the account.

walletID

string <uuid> required
ID of the wallet

Response

application/json
A Moov wallet to store funds for transfers.

availableBalance

object required
Available balance of the wallet.
An integer value representing money in a specific currency.
right_key Show child attributes

currency

string <=3 characters Pattern
A 3-letter ISO 4217 currency code.

value

integer<int64>
Quantity in the smallest unit of the specified currency. In USD this is cents, for example, $12.04 is 1204 and $0.99 is 99.

valueDecimal

string
Same as value, but a decimal-formatted numerical string that represents up to 9 decimal place precision.
A decimal-formatted numerical string that represents up to 9 decimal place precision.

walletID

string<uuid> <=36 characters required
UUID