---
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`

## Request

- Base URL: `https://api.eflow.team/v1`
- URL: `https://api.eflow.team/v1/networks/advertisers/{advertiserId}/users`
- Auth: API key in header `X-Eflow-Api-Key`
- TypeScript: <https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains/docs/networks/advertisers/:advertiserId/users/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/everflow/apis/everflow-network-api-tracking-domains.md) - [All operations](https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains/llms.txt) - [OpenAPI document](https://skmtc.dev/everflow/apis/everflow-network-api-tracking-domains/revisions/39242cee0e32?raw)