Sign in
DigitalOcean-public.v2-new_Billing

Get Customer Balance

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

get/v2/customers/my/balance

Response

The response will be a JSON object that contains the following attributes

month_to_date_balancestring

Balance as of the generated_at time. This value includes the account_balance and month_to_date_usage.

account_balancestring

Current balance of the customer's most recent billing activity. Does not reflect month_to_date_usage.

month_to_date_usagestring

Amount used in the current billing period as of the generated_at time.

generated_atstring date-time

The time at which balances were most recently generated.

Example response

{
  "month_to_date_balance": "23.44",
  "account_balance": "12.23",
  "month_to_date_usage": "11.21",
  "generated_at": "2019-07-09T15:01:12Z"
}

Changes

Changed in 4 of the 8 revisions of this API.14