Required. The name of the buyer. Format: buyers/{accountId}
Query parameters
Parameters
pageSize
integer
Requested page size. If left blank, a default page size of 500 will be applied.
pageToken
string
A token identifying a page of results the server should return. Typically, this is the value of [ListClientsResponse.nextPageToken][nextPageToken] returned from the previous call to the [list][clients.list] method.
filter
string
Query string using the Filtering Syntax Supported fields for filtering are:
partnerClientId
Use this field to filter the clients by the partnerClientId. For example, if the partnerClientId of the client is "1234", the value of this field should be partnerClientId = "1234", in order to get only the client whose partnerClientId is "1234" in the response.
Request body
The request body must be empty.
Response body
Response message for the [list][clients.list] method.
If successful, the response body contains data with the following structure:
A token to retrieve the next page of results. Pass this value in the ListClientsRequest.pageToken field in the subsequent call to the [list][clients.list] method to retrieve the next page of results.
[[["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-06-12 UTC."],[[["\u003cp\u003eLists all clients associated with the current buyer using a \u003ccode\u003eGET\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering of clients by partnerClientId and pagination of results.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of clients and a token for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/authorized-buyers-marketplace\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This content outlines how to retrieve a list of clients for a specific buyer using a `GET` request. The request URL includes a required `parent` path parameter (buyer's account ID). Optional query parameters (`pageSize`, `pageToken`, `filter`) allow for pagination and filtering by `partnerClientId`. The request body must be empty. A successful response contains a list of `clients` and a `nextPageToken` for retrieving subsequent pages. Authorization requires a specific OAuth scope.\n"],null,["# Method: buyers.clients.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListClientsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists all the clients for the current buyer.\n\n### HTTP request\n\n`GET https://authorizedbuyersmarketplace.googleapis.com/v1alpha/{parent=buyers/*}/clients`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the buyer. Format: `buyers/{accountId}` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. If left blank, a default page size of 500 will be applied. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of \\[ListClientsResponse.nextPageToken\\]\\[nextPageToken\\] returned from the previous call to the \\[list\\]\\[clients.list\\] method. |\n| `filter` | `string` Query string using the [Filtering Syntax](https://developers.google.com/authorized-buyers/apis/guides/list-filters) Supported fields for filtering are: - partnerClientId Use this field to filter the clients by the partnerClientId. For example, if the partnerClientId of the client is \"1234\", the value of this field should be `partnerClientId = \"1234\"`, in order to get only the client whose partnerClientId is \"1234\" in the response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for the \\[list\\]\\[clients.list\\] method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"clients\": [ { object (/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.clients#Client) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `clients[]` | `object (`[Client](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.clients#Client)`)` The returned list of clients. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ListClientsRequest.pageToken](/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.clients/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to the \\[list\\]\\[clients.list\\] method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/authorized-buyers-marketplace`"]]