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

# List Events

`GET /events`

Lists identity-linked events, most recent first. Pass identifier for one person's journey, or omit it to list events for an account within an explicit time range. 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
- `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`

account events listed

- object
  - `data` object[], required
    - `context` object, nullable
      - `ad_campaign_id` string, nullable
      - `ad_id` string, nullable
      - `ad_set_id` string, nullable
      - `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
      - `app` object, nullable
        - `domain_id` string, nullable
        - `icon_url` string, nullable
        - `id` string
        - `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

- `401` — Unauthorized

## Changes

- **2026-07-26** `60bbb4a6ffbc` — 1 breaking, 2 warning, 16 info
  - the `data/items/event_time` response's property type/format changed from `integer`/`` to `string`/`date-time` for status `200`
  - deleted the `query` request parameter `person_id`
  - removed the optional property `data/items/user/state` from the response with the `200` status
  - added the new optional `query` request parameter `attribution_model`
  - …15 more

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/events/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/60bbb4a6ffbc/schema)