---
title: "GET /v2beta1/accounts/{accountId}/clients"
method: GET
path: "/v2beta1/accounts/{accountId}/clients"
tags: ["accounts"]
---

# GET /v2beta1/accounts/{accountId}/clients

`GET /v2beta1/accounts/{accountId}/clients`

## Request

- Base URL: `https://adexchangebuyer.googleapis.com`
- URL: `https://adexchangebuyer.googleapis.com/v2beta1/accounts/{accountId}/clients`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/adexchange.buyer`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/adexchange.buyer`

Lists all the clients for the current sponsor buyer.

## Path parameters

- `accountId` string, int64, required

## Query parameters

- `pageSize` integer
- `pageToken` string
- `partnerClientId` string

## Response `200`

Successful response

- ListClientsResponse
  - `clients` Client[]: The returned list of clients.
    - `clientAccountId` string, int64: The globally-unique numerical ID of the client. The value of this field is ignored in create and update operations.
    - `clientName` string: Name used to represent this client to publishers. You may have multiple clients that map to the same entity, but for each client the combination of `clientName` and entity must be unique. You can specify this field as empty. Maximum length of 255 characters is allowed.
    - `entityId` string, int64: Numerical identifier of the client entity. The entity can be an advertiser, a brand, or an agency. This identifier is unique among all the entities with the same type. The value of this field is ignored if the entity type is not provided. A list of all known advertisers with their identifiers is available in the [advertisers.txt](https://storage.googleapis.com/adx-rtb-dictionaries/advertisers.txt) file. A list of all known brands with their identifiers is available in the [brands.txt](https://storage.googleapis.com/adx-rtb-dictionaries/brands.txt) file. A list of all known agencies with their identifiers is available in the [agencies.txt](https://storage.googleapis.com/adx-rtb-dictionaries/agencies.txt) file.
    - `entityName` string: The name of the entity. This field is automatically fetched based on the type and ID. The value of this field is ignored in create and update operations.
    - `entityType` 'ENTITY_TYPE_UNSPECIFIED' | 'ADVERTISER' | 'BRAND' | 'AGENCY' | 'ENTITY_TYPE_UNCLASSIFIED': An optional field for specifying the type of the client entity: `ADVERTISER`, `BRAND`, or `AGENCY`.
    - `partnerClientId` string: Optional arbitrary unique identifier of this client buyer from the standpoint of its Ad Exchange sponsor buyer. This field can be used to associate a client buyer with the identifier in the namespace of its sponsor buyer, lookup client buyers by that identifier and verify whether an Ad Exchange counterpart of a given client buyer already exists. If present, must be unique among all the client buyers for its Ad Exchange sponsor buyer.
    - `role` 'CLIENT_ROLE_UNSPECIFIED' | 'CLIENT_DEAL_VIEWER' | 'CLIENT_DEAL_NEGOTIATOR' | 'CLIENT_DEAL_APPROVER': The role which is assigned to the client buyer. Each role implies a set of permissions granted to the client. Must be one of `CLIENT_DEAL_VIEWER`, `CLIENT_DEAL_NEGOTIATOR` or `CLIENT_DEAL_APPROVER`.
    - `status` 'CLIENT_STATUS_UNSPECIFIED' | 'DISABLED' | 'ACTIVE': The status of the client buyer.
    - `visibleToSeller` boolean: Whether the client buyer will be visible to sellers.
  - `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 accounts.clients.list method to retrieve the next page of results.

## Changes

- **2026-10-10** `af1a744df07b`: 1 breaking
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/adexchangebuyer2/changes/v2beta1/accounts/:accountId/clients/get.md)

---

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