---
title: "List Widget Events"
method: GET
path: "/admin/chat-tool-calls/widgets/events"
tags: ["admin_chat_tool_calls"]
---

# List Widget Events

`GET /admin/chat-tool-calls/widgets/events`

## Query parameters

- `start` string, date-time, nullable
- `end` string, date-time, nullable
- `widget` string, nullable
- `surface` string, nullable
- `origin` string, nullable
- `user_email` string, nullable
- `user_id` string, nullable
- `chat_id` string, nullable
- `closed` string, nullable
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- WidgetEventsPage
  - `items` WidgetEventOut[], required
    - `id` string, required
    - `chat_id` string, required
    - `message_id` string, nullable
    - `ordinal` integer, required
    - `user_id` string, required
    - `user_email` string, required
    - `user_role` string, required
    - `surface` string, required
    - `origin` string, nullable
    - `widget` string, required
    - `payload_excerpt` string, nullable
    - `payload_chars` integer, required
    - `closed` boolean, required
    - `trigger_message` string, nullable
    - `tool_names` string[]
    - `applied` boolean, nullable
    - `created_at` string, date-time, required
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)