Skip to main content

balances

Creates, updates, deletes, gets or lists a balances resource.

Overview

Namebalances
TypeResource
Iddigitalocean.billing.balances

Fields

NameDatatypeDescription
account_balancestringCurrent balance of the customer's most recent billing activity. Does not reflect month_to_date_usage.
generated_atstringThe time at which balances were most recently generated.
month_to_date_balancestringBalance as of the generated_at time. This value includes the account_balance and month_to_date_usage.
month_to_date_usagestringAmount used in the current billing period as of the generated_at time.

Methods

NameAccessible byRequired ParamsDescription
balance_getSELECTTo retrieve the balances on a customer's account, send a GET request to /v2/customers/my/balance.

SELECT examples

To retrieve the balances on a customer's account, send a GET request to /v2/customers/my/balance.

SELECT
account_balance,
generated_at,
month_to_date_balance,
month_to_date_usage
FROM digitalocean.billing.balances
;