---
title: "List ad account users"
method: GET
path: "/cm/v1/auth/ad-account/{ad_account_id}/users"
tags: ["User"]
---

# List ad account users

`GET /cm/v1/auth/ad-account/{ad_account_id}/users`

## Request

- Base URL: `https://api.moloco.cloud`
- URL: `https://api.moloco.cloud/cm/v1/auth/ad-account/{ad_account_id}/users`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api/docs/cm/v1/auth/ad-account/:ad_account_id/users/get.ts> (a function with typed inputs; its response is checked against the schema)

List users under a certain ad account.
With `include_role` query parameter, response can include roles.
API callers who have a WORKPLACE_OWNER or AD_ACCOUNT_OWNER or AD_ACCOUNT_MEMBER role can call this API.

## Path parameters

- `ad_account_id` string, required

## Query parameters

- `include_role` boolean

## Response `200`

A successful response.

- MessagesListAdAccountUsersResponse
  - `users_with_infos` MessagesUserWithInfo[]: List of users contain roles.
    - `user` DspUser: User represents a single user.
      - `email` string: Email of User. Immutable.
      - `id` string: ID of User. Immutable.
      - `name` string: First name of the User.
      - `last_name` string: Last name of the User.
      - `company_name` string: Company name of the User.
      - `terms_agreed` boolean: Whether the user agreed to terms and privacy policy.
      - `marketing_agreed` boolean: Whether the user agreed to receive marketing purpose informations.
      - `locale` 'UNKNOWN_LOCALE' | 'EN_US' | 'KO_KR' | 'JA_JP': Locale enumerates the supported user locale values. - EN_US: English (United States) - KO_KR: Korean (South Korea) - JA_JP: Japanese (Japan)
      - `created_at` string, date-time: The time when a user was created.
      - `updated_at` string, date-time: The time when a user was updated.
    - `signed_up` boolean: Signed up status of user.
    - `roles` DspRole[]: List of roles the user has.
      - `type` 'WORKPLACE_OWNER' | 'AD_ACCOUNT_OWNER' | 'AD_ACCOUNT_MEMBER' | 'AD_ACCOUNT_VIEWER': - WORKPLACE_OWNER: Workplace owner represents a user who can do anything in a given workplace. - AD_ACCOUNT_OWNER: Ad account owner represents a user who can do anything in a given ad account. - AD_ACCOUNT_MEMBER: Ad account member can view all users of the Ad Account. Can invite new users as Ad Account Member or Ad Account Viewer Can edit your own information (ex: name) Can create and edit ad campaigns - AD_ACCOUNT_VIEWER: Ad account Viewer role offers a limited set of permissions that allows users only to read the basic information of the resources.
      - `workplace_id` string: The workplace bound to the role.
      - `ad_account_id` string: The ad account id bound to role.
      - `exchange_id` string: The exchange id bound to role.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api.md) - [All operations](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moloco/apis/moloco-ads-campaign-management-api/revisions/fa372006b0f6?raw)