---
title: "List Events"
method: GET
path: "/events"
tags: ["Events"]
---

# List Events

`GET /events`

Lists identity-linked events, most recent first by default. Pass identifier for one person's journey, or omit it to list events for an account within an explicit time range. Pass direction=asc to read a journey forwards from where it starts. Events are shaped like the POST /events intake: attribution in context, identity in user.

## Query parameters

- `identifier` string
- `account_id` string
- `from` string, date-time
- `to` string, date-time
- `first` integer
- `after` string
- `before` string
- `direction` 'asc' | 'desc'
- `event` string
- `source` string
- `attribution_model` 'last_touch' | 'first_touch'
- `country` string
- `city` string
- `device` string
- `browser` string
- `os` string
- `utm_source` string
- `hostname` string
- `page` string

## Response `200`

events listed oldest first

- object
  - `data` object[], required
    - `context` object, nullable
      - `ad_campaign_id` string, nullable
      - `ad_click_id` string, nullable — Stable identity for the ad click this event belongs to. Every event from one click carries the same value, so events group into clicks without re-deriving them.
      - `ad_click_type` string, nullable — How the ad click was identified: the network's click-id param (`fbclid`, `ttclid`, `gclid`, `gbraid`, `wbraid`, `twclid`) or `synthetic` when the click carried none.
      - `ad_id` string, nullable
      - `ad_set_id` string, nullable
      - `source_type` 'ad_click' | 'lead_form' | 'external_ad_click' | 'referrer' | 'null', nullable — How this event counts as an acquisition touch, using the same rule attribution credits a conversion with. `ad_click` and `lead_form` resolved to a Whop ad; `external_ad_click` is a paid click on a campaign run outside Whop; `referrer` is organic. Null when the event is not a touch.
      - `utm_campaign` string, nullable
      - `utm_content` string, nullable
      - `utm_medium` string, nullable
      - `utm_source` string, nullable
      - `utm_term` string, nullable
    - `currency` string, nullable
    - `custom_name` string, nullable
    - `event_id` string, required
    - `event_name` string, required
    - `event_time` string, date-time, required
    - `id` string, required
    - `path` string, nullable
    - `person_id` string, required
    - `questions` object[], nullable
      - `answer` string, nullable
      - `id` string, nullable
      - `key` string, nullable
      - `options` string[], nullable
      - `question` string, nullable
      - `type` string, nullable
    - `referrer_url` string, nullable
    - `related` object, nullable — Hydrated details for the records this event references. Only present keys resolved.
      - `account` object, nullable
        - `id` string
        - `logo_url` string, nullable
        - `route` string, nullable
        - `title` string, nullable
      - `ad` object, nullable — The Whop ad this event's click resolved to.
        - `id` string
        - `thumbnail_url` string, nullable
        - `title` string, nullable
      - `ad_campaign` object, nullable — The Whop ad campaign this event's click resolved to, read from the ad entity tree rather than the click's url params.
        - `id` string
        - `platform` string, nullable
        - `title` string, nullable
      - `ad_group` object, nullable — The Whop ad group this event's click resolved to.
        - `id` string
        - `title` string, nullable
      - `app` object, nullable
        - `domain_id` string, nullable
        - `icon_url` string, nullable
        - `id` string
        - `title` string, nullable
      - `audience` object, nullable — The saved audience this event came from. Present on the identify events an audience ingest writes for each of its members.
        - `audience_type` 'custom' | 'lookalike' | 'null', nullable
        - `file_name` string, nullable
        - `id` string
        - `source_type` 'csv_upload' | 'people_filter' | 'null', nullable
        - `title` string, nullable
      - `payment` object, nullable
        - `card_brand` string, nullable
        - `card_last4` string, nullable
        - `id` string
        - `provider` string, nullable
      - `plan` object, nullable
        - `billing_period` integer, nullable
        - `currency` string, nullable
        - `id` string
        - `initial_price` number, nullable
        - `renewal_price` number, nullable
        - `title` string, nullable
      - `product` object, nullable
        - `id` string
        - `route` string, nullable
        - `title` string, nullable
      - `user` object, nullable
        - `avatar_url` string, nullable
        - `id` string
        - `name` string, nullable
        - `username` string, nullable
    - `total_usd_amount` number, nullable
    - `url` string, nullable
    - `user` object, nullable
      - `city` string, nullable
      - `country` string, nullable
      - `email` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `name` string, nullable
      - `phone` string, nullable
    - `value` number, nullable
  - `page_info` object, required
    - `end_cursor` string, nullable
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable

## 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/db0883548bc5/schema)