Method: billingAccounts.subAccounts.list

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

HTTP request

GET https://cloudbilling.googleapis.com/v1/{parent=billingAccounts/*}/subAccounts

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Optional. The parent resource to list billing accounts from. Format: - organizations/{organization_id}, for example, organizations/12345678 - billingAccounts/{billing_account_id}, for example, billingAccounts/012345-567890-ABCDEF

Query parameters

Parameters
pageSize

integer

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 subAccounts.list call. If unspecified, the first page of results is returned.

filter

string

Options for how to filter the returned billing accounts. This only supports filtering for subaccounts under a single provided parent billing account. (for example, 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 an instance of ListBillingAccountsResponse.

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 Authentication Overview.