---
title: "List Advertiser Users by Advertiser"
method: GET
path: "/networks/advertisers/{advertiserId}/users"
tags: ["Advertiser Users"]
---

# List Advertiser Users by Advertiser

`GET /networks/advertisers/{advertiserId}/users`

## Path parameters

- `advertiserId` integer, required

## Query parameters

- `relationship` 'logins' | 'password_history' | 'api' | 'customizations'

## Response `200`

- object
  - `users` AdvertiserUser[]
    - `network_advertiser_user_id` integer — Unique advertiser user ID.
    - `network_id` integer — The network ID this user belongs to.
    - `network_advertiser_id` integer — The advertiser ID this user belongs to.
    - `first_name` string — The advertiser user's first name.
    - `last_name` string — The advertiser user's last name.
    - `email` string — The advertiser user's email address.
    - `title` string — The advertiser user's title.
    - `account_status` 'active' | 'inactive' | 'suspended' — The advertiser user's account status.
    - `work_phone` string — The advertiser user's work phone number.
    - `cell_phone` string — The advertiser user's cell phone number.
    - `instant_messaging_id` integer — The ID of an instant messaging platform. Values are 0 for None, 1 for Skype, 2 for Yahoo Messenger, 3 for Telegram, 4 for WhatsApp, 5 for Other.
    - `instant_messaging_identifier` string — The advertiser user's instant messaging identifier.
    - `language_id` integer — The advertiser user's language ID.
    - `timezone_id` integer — The advertiser user's timezone ID.
    - `currency_id` string — The advertiser user's currency ID (ISO currency code).
    - `relationship` object, nullable — Related data for this advertiser user. Populate by passing `relationship` query parameters (e.g. `?relationship=logins&relationship=api`).
      - `logins` object — The user's list of logins.
        - `total` integer — Total number of login records.
        - `entries` object[] — List of login records.
      - `password_history` object — The user's password changes history.
        - `total` integer — Total number of password change records.
        - `entries` object[] — List of password change records.
      - `customization` object — The user's customizations.
        - `network_advertiser_user_id` integer — The advertiser user ID this customization belongs to.
        - `dashboard_refresh_rate` integer — Dashboard refresh rate in seconds.
        - `pins_customization` string — JSON string of pinned dashboard widgets.
        - `columns_customization` string — JSON string of column display preferences.
        - `time_created` integer — Unix timestamp of creation.
        - `time_saved` integer — Unix timestamp of last update.
      - `api` object — API key and whitelisted IPs for this user.
        - `api_key` string — The user's API key. Empty if not generated.
        - `restricted_ips` string[], nullable — List of whitelisted IP addresses. Null if unrestricted.
    - `time_created` integer — Unix timestamp of creation.
    - `time_saved` integer — Unix timestamp of last update.

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)