Method: billingAccounts.budgets.list

Returns a list of budgets for a billing account.

HTTP request

GET https://billingbudgets.googleapis.com/v1beta1/{parent=billingAccounts/*}/budgets

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Name of billing account to list budgets under. Values are of the form billingAccounts/{billingAccountId}.

Authorization requires the following Google IAM permission on the specified resource parent:

  • billing.budgets.list

Query parameters

Parameters
pageSize

number

Optional. The maximum number of budgets to return per page. The default and maximum value are 100.

pageToken

string

Optional. The value returned by the last ListBudgetsResponse which indicates that this is a continuation of a prior budgets.list call, and that the system should return the next page of data.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response for budgets.list

JSON representation
{
  "budgets": [
    {
      object (Budget)
    }
  ],
  "nextPageToken": string
}
Fields
budgets[]

object (Budget)

List of the budgets owned by the requested billing account.

nextPageToken

string

If not empty, indicates that there may be more budgets that match the request; this value should be passed in a new ListBudgetsRequest.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-billing

Try it!