---
title: "List People"
method: GET
path: "/people"
tags: ["People"]
---

# List People

`GET /people`

Lists the people (visitors and customers) of an account: the identity-linked person profiles aggregated from every pixel, payment, and platform event — identities, purchases and LTV, geo/device profile, traffic sources, and first/last marketing touches.

## Query parameters

- `account_id` string
- `query` string
- `source` string[]
- `attribution_model` 'last_touch' | 'first_touch'
- `event_name` string[]
- `custom_event` string
- `event_from` string, date-time
- `event_to` string, date-time
- `audience_id` string
- `user_id` string
- `email` string
- `phone` string
- `country` string
- `has_purchased` boolean
- `contactable` boolean
- `first_seen_within_days` integer
- `last_seen_within_days` integer
- `first_seen_after` string, date-time
- `first_seen_before` string, date-time
- `last_seen_after` string, date-time
- `last_seen_before` string, date-time
- `first` integer
- `after` string
- `before` string
- `order` 'first_seen_at' | 'last_seen_at' | 'first_purchase_at' | 'last_purchase_at' | 'purchase_count' | 'event_count' | 'ltv' | 'aov' | 'name' | 'email'
- `direction` 'asc' | 'desc'

## Headers

- `Api-Version-Date` string

## Response `200`

people listed

- object
  - `data` object[], required
    - `account_id` string, required
    - `aov` number
    - `device` object
      - `browser` string, nullable
      - `device` string, nullable
      - `os` string, nullable
    - `email` string, nullable — The email from the person's most recent event that carried one.
    - `event_count` integer, required
    - `first_purchase_at` string, date-time, nullable
    - `first_seen_at` string, date-time, required
    - `first_source` object, nullable — Where a visit came from: a whop ad click, a lead form, an external ad, or a referring site.
      - `ad` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `thumbnail_url` string, nullable
      - `ad_group` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `thumbnail_url` string, nullable
      - `campaign` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `thumbnail_url` string, nullable
      - `domain` string, nullable
      - `occurred_at` string, date-time, nullable
      - `platform` string, nullable
      - `type` 'ad_click' | 'lead_form' | 'external_ad_click' | 'referrer' | 'utm', required
      - `utm_source` string, nullable
    - `id` string, required
    - `last_ip` string, nullable
    - `last_purchase_at` string, date-time, nullable
    - `last_seen_at` string, date-time, required
    - `last_source` object, nullable — Where a visit came from: a whop ad click, a lead form, an external ad, or a referring site.
      - `ad` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `thumbnail_url` string, nullable
      - `ad_group` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `thumbnail_url` string, nullable
      - `campaign` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `thumbnail_url` string, nullable
      - `domain` string, nullable
      - `occurred_at` string, date-time, nullable
      - `platform` string, nullable
      - `type` 'ad_click' | 'lead_form' | 'external_ad_click' | 'referrer' | 'utm', required
      - `utm_source` string, nullable
    - `location` object
      - `city` string, nullable
      - `continent` string, nullable
      - `country` string, nullable
    - `ltv` number
    - `member` object, nullable — The user's member record at this account, when they are a member of it.
      - `id` string, required
      - `joined_at` string, date-time, nullable
      - `status` string, nullable
      - `usd_total_spend` number
    - `name` string, nullable — The name from the person's most recent event that carried one.
    - `phone` string, nullable — The phone from the person's most recent event that carried one.
    - `purchase_count` integer, required
    - `timezone` string, nullable
    - `user` object, nullable — The person's primary whop user, when one of their identities is a whop account.
      - `id` string, required
      - `name` string, nullable
      - `profile_pic_url` string, nullable
      - `username` string, required
  - `page_info` object, required
    - `end_cursor` string, nullable
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable
  - `total_count` integer

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/a8a43db4255f/schema)