Tizondocs
ReferenceWallet

Retrieve the wallet's aging

GET
/v1/wallet/aging

What the account owes and how old that debt is. Credits pay down debits oldest first (FIFO), so the oldest open debit is the first purchase the wallet's credits have not fully covered yet. It is due net_terms_days after it was made, and once it is past due the account is overdue. Paying down the oldest debits clears it, even if the balance is still negative.

Authorization

ApiKey
AuthorizationBearer <token>

An account API key, sent as Authorization: Bearer tz_live_…. The prefix selects the mode: tz_test_ for sandbox, tz_live_ for real money.

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/wallet/aging"
{  "object": "wallet_aging",  "wallet_id": "string",  "outstanding": {    "amount": 1450,    "currency": "USD"  },  "oldest_open_debit": null,  "net_terms_days": 0,  "status": "current"}