Method: billingAccounts.list

Lists the billing accounts that the current authenticated user has permission to view.

HTTP request

GET https://cloudbilling.googleapis.com/v1/billingAccounts

The URL uses Google API HTTP annotation syntax.

Query parameters

Parameters
pageSize

number

Requested page size. The maximum page size is 100; this is also the default.

pageToken

string

A token identifying a page of results to return. This should be a nextPageToken value returned from a previous billingAccounts.list call. If unspecified, the first page of results is returned.

filter

string

Options for how to filter the returned billing accounts. Currently this only supports filtering for subaccounts under a single provided reseller billing account. (e.g. "masterBillingAccount=billingAccounts/012345-678901-ABCDEF"). Boolean algebra and other fields are not currently supported.

Request body

The request body must be empty.

Response body

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

Response message for billingAccounts.list.

JSON representation
{
  "billingAccounts": [
    {
      object(BillingAccount)
    }
  ],
  "nextPageToken": string
}
Fields
billingAccounts[]

object(BillingAccount)

A list of billing accounts.

nextPageToken

string

A token to retrieve the next page of results. To retrieve the next page, call billingAccounts.list again with the pageToken field set to this value. This field is empty if there are no more results to retrieve.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the Auth Guide.