GET/2010-04-01/Accounts/{AccountSid}/Balance.json

Get an account balance

Retrieves the balance for a specified account. Use the account SID to identify the account whose balance and currency you need. Balance changes may not appear immediately, and child accounts do not include balance information.

1 parameter
AccountSidstringrequired
The unique SID of the account whose balance to retrieve. Must match the account SID format: 34 characters beginning with AC followed by 32 hexadecimal characters.

1 status code
200Returns the account SID, balance as a string, and the currency units for that balance. Balance changes may not be reflected immediately, and child accounts do not contain balance information.
account_sidstringoptional
The unique SID identifier of the Account.
balancestringoptional
The balance of the Account, in units specified by the unit parameter. Balance changes may not be reflected immediately. Child accounts do not contain balance information
currencystringoptional
The units of currency for the account balance

Error handling

The AccountSid path parameter must match the account SID format: 34 characters beginning with AC followed by 32 hexadecimal characters. The account must be one for which balance information is available; child accounts do not contain balance information.