Skip to main content
GET
/
account
/
wallet
Get Wallet
curl --request GET \
  --url https://api.fyatu.com/api/v3.20/account/wallet \
  --header 'Authorization: Bearer <token>'
{}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Returns your business wallet balance. All card issuance, funding, and fee operations draw from this wallet.

Response Fields

FieldTypeDescription
availablenumberBalance available for new operations (USD)
reservednumberBalance held for pending card operations
totalnumberTotal balance (available + reserved)
currencystringAlways USD

Balance Reservation

When you issue or fund a card, the required amount plus fees is reserved from your wallet immediately. The reservation releases to the card or is returned to available once the operation settles.
EventEffect on availableEffect on reserved
Card creation initiatedDecreases by amount + feeIncreases
Card creation succeedsDecreases (transferred to card)
Card creation failsIncreases (refunded)Decreases
Monitor your available balance before bulk card issuance operations. A balance below the required amount causes 402 INSUFFICIENT_BALANCE errors.

Authorizations

Authorization
string
header
required

JWT access token obtained from POST /auth/token

Response

Wallet retrieved

The response is of type object.