List all sub-accounts for a given multi client account. This is a convenience wrapper for the more powerful accounts.list method. This method will produce the same results as calling ListsAccounts with the following filter: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))
HTTP request
GET https://merchantapi.googleapis.com/accounts/v1beta/{provider=accounts/*}:listSubaccounts
Required. The aggregation service provider. Format: accounts/{providerId}
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.
pageToken
string
Optional. A page token, received from a previous accounts.list call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to accounts.list must match the call that provided the page token.
Request body
The request body must be empty.
Response body
Response message for the accounts.listSubaccounts method.
If successful, the response body contains data with the following structure:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-17 UTC."],[[["Lists all sub-accounts for a given multi-client account, effectively acting as a wrapper for the `accounts.list` method with a specific filter."],["Uses a `GET` request to the specified URL with path and query parameters for retrieving sub-accounts."],["Requires an empty request body and returns a response containing an array of sub-accounts and a pagination token."],["Requires authorization with the `https://www.googleapis.com/auth/content` scope."]]],["This document details the `listSubaccounts` method for retrieving sub-accounts related to a parent account. It uses an HTTP GET request to `merchantapi.googleapis.com/accounts/v1beta/{provider=accounts/*}:listSubaccounts`. The `provider` path parameter is mandatory, formatted as `providers/{providerId}`. Optional query parameters include `pageSize` (max 500) and `pageToken` for pagination. The request body is empty. The response body, in JSON format, contains an array of `accounts` and a `nextPageToken` for subsequent pages. Requires OAuth scope `https://www.googleapis.com/auth/content`.\n"]]