---
title: "List handoff events"
method: GET
path: "/handoff-analytics/events"
---

# List handoff events

`GET /handoff-analytics/events`

Returns a paginated list of individual AI-to-human handoff events, newest first. Each event includes the AI-written summary and explanation of why it handed off, the handoff reasons, sentiment, and the session ID. Filter by reason (e.g. insufficient_tools) and date range to analyze recurring gaps.

## Query parameters

- `cursor` string
- `reason` 'ai_implied_handoff' | 'based_on_instructions' | 'instructions_not_clear' | 'insufficient_knowledge' | 'insufficient_tools' | 'prohibited_topic' | 'user_requested_human_assistance'
- `start_date` string
- `end_date` string

## Response `200`

Default Response

- ListHandoffEventsOutput
  - `items` object[], required
    - `session_id` string, required
    - `summary` string, required
    - `explanation` string, nullable, required
    - `reasons` string[], required
    - `sentiment` 'angry' | 'happy' | 'neutral', nullable, required
    - `created_at` string, required
  - `next` string, nullable, required
  - `total` number, required

## Other responses

- `500` — Internal Server Error

---

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