Read a wallet

GET/v1/wallets/{walletId}

One wallet and its balance.

Permissionwallets:read

AuthenticationSigned read

Staff-set limits it counts towardAll requests

.NET SDKanis.Wallets.GetAsync(walletId)

Parameters

Name	In	Type	Notes
`walletId`required	`path`	UUID	A UUID, lower-case with hyphens.

Signed with your key. No body, no nonce.

Headers: Signature-Input, Signature, X-Anis-Date, Accept-Language (optional). The SDKs set all of them for you.

Body: none.

Status	Meaning	Body
200	Success.	Wallet
401	Refused: not authenticated.	Problem
403	Refused: not allowed.	Problem
404	Refused: not found, or not yours.	Problem
429	Refused: a limit was reached.	Problem
503	No decision: a dependency was unavailable.	Problem

Every answer is signed by Anis; the SDKs check it before you see it.

Every refusal is a signed problem. Branch on its code; each links to what it means and what to do.

Field	Type	Notes
`id`always present	UUID	The wallet’s id. Every wallet-level call takes it in the address.
`name`always present	string	The wallet’s name.
`currency`always present	string	The currency the wallet holds and buys in.
`balance`always present	Money	The balance you can spend now, with the moment it was read.

Field	Type	Notes
`amount`always present	string	A decimal string with exactly three decimals, such as `"10.500"` — never a JSON number.
`currency`always present	string	The currency code, such as `LYD`: always the wallet’s currency.
`asOf`	string (date-time)	When this price or balance was read.