---
title: "GET /v1/buyers/{buyersId}/clients"
method: GET
path: "/v1/buyers/{buyersId}/clients"
tags: ["buyers"]
---

# GET /v1/buyers/{buyersId}/clients

`GET /v1/buyers/{buyersId}/clients`

## Request

- Base URL: `https://authorizedbuyersmarketplace.googleapis.com`
- URL: `https://authorizedbuyersmarketplace.googleapis.com/v1/buyers/{buyersId}/clients`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/authorized-buyers-marketplace`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/authorized-buyers-marketplace`

Lists all the clients for the current buyer.

## Path parameters

- `buyersId` string, required

## Query parameters

- `filter` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListClientsResponse: Response message for the list method.
  - `clients` Client[]: The returned list of clients.
    - `displayName` string: Required. Display name shown to publishers. Must be unique for clients without partnerClientId specified. Maximum length of 255 characters is allowed.
    - `name` string: Output only. The resource name of the client. Format: `buyers/{accountId}/clients/{clientAccountId}`
    - `partnerClientId` string: Arbitrary unique identifier provided by the buyer. This field can be used to associate a client with an identifier in the namespace of the buyer, lookup clients by that identifier and verify whether an Authorized Buyers account of the client already exists. If present, must be unique across all the clients.
    - `role` 'CLIENT_ROLE_UNSPECIFIED' | 'CLIENT_DEAL_VIEWER' | 'CLIENT_DEAL_NEGOTIATOR' | 'CLIENT_DEAL_APPROVER': Required. The role assigned to the client. Each role implies a set of permissions granted to the client.
    - `sellerVisible` boolean: Whether the client will be visible to sellers.
    - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'INACTIVE': Output only. The state of the client.
  - `nextPageToken` string: A token to retrieve the next page of results. Pass this value in the ListClientsRequest.pageToken field in the subsequent call to the list method to retrieve the next page of results.

## Changes

- **2026-10-29** `4e374f878f32`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/changes/v1/buyers/:buyersId/clients/get.md)

---

[API](https://skmtc.dev/google/apis/authorizedbuyersmarketplace.md) - [All operations](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/authorizedbuyersmarketplace/revisions/4e374f878f32?raw)