---
title: "List Meeting Events"
method: GET
path: "/sessions/meeting-events"
tags: ["Sessions"]
---

# List Meeting Events

`GET /sessions/meeting-events`

## Request

- Base URL: `https://api.karumi.ai/api/v1`
- URL: `https://api.karumi.ai/api/v1/sessions/meeting-events`
- Auth: none declared

List meeting CTA clicks and bookings across the organization's sessions.

Each event is returned with the demo visitor's email so the data can be
cross-referenced against your own booking records. Filter by project,
event type, and date range to build per-day click/booking reports.

## Query parameters

- `project_id` string, uuid, nullable: Filter by project ID
- `event_type` string, nullable: Filter by event type: 'meeting_cta_clicked', 'booking_offered' or 'meeting_booked'
- `start_date` string, date-time, nullable: Filter events after this date
- `end_date` string, date-time, nullable: Filter events before this date
- `limit` integer: Number of events to return
- `offset` integer: Number of events to skip

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- PaginatedSessionEvents: Paginated response for the session events list.
  - `items` PublicSessionEvent[], required
    - `id` string, uuid, required
    - `session_id` string, uuid, required
    - `project_id` string, uuid, nullable, required
    - `event_type` string, required: Event type, e.g. 'meeting_cta_clicked', 'booking_offered' or 'meeting_booked'
    - `url` string, nullable: The meeting link the event relates to
    - `visitor_email` string, nullable: Email of the demo visitor, if known
    - `metadata` object, nullable: Event-specific data. For 'meeting_booked': `provider` (hubspot, outreach, calendly, chilipiper or calcom); for HubSpot also the booked contact (first/last name, email), slot timerange, organizer name, and link type; for Chili Piper also `event_id`, `route_id`, `assignee_id` and the slot timerange; for Cal.com also `booking_uid`, `event_type_id`, `status` and the slot timerange. For 'booking_offered': the rep's `rep_name` and `rep_email` when the offered link is theirs, or the `message` shown instead of a link.
    - `created_at` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/karumi/apis/karumi-public-api.md) - [All operations](https://skmtc.dev/karumi/apis/karumi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/karumi/apis/karumi-public-api/revisions/194842153db4?raw)