---
title: "Get handoff analytics"
method: GET
path: "/handoff-analytics"
---

# Get handoff analytics

`GET /handoff-analytics`

Get a comprehensive overview of AI-to-human handoff events for a date range, including reason breakdowns, sentiment analysis, trends, and referenced resources.

## Query parameters

- `start_date` string
- `end_date` string
- `instruction_id` string

## Response `200`

Default Response

- HandoffAnalyticsPublicResponseDto
  - `summary` string, required
  - `total_handoffs` number, required
  - `total_sessions` number, required
  - `start_date` string, required
  - `end_date` string, required
  - `reasons` object[], required
    - `reason` 'ai_implied_handoff' | 'based_on_instructions' | 'instructions_not_clear' | 'insufficient_knowledge' | 'insufficient_tools' | 'prohibited_topic' | 'user_requested_human_assistance', required
    - `count` number, required
    - `percentage` number, required
  - `reason_combinations` object[], required
    - `reasons` string[], required
    - `session_count` number, required
    - `percentage` number, required
  - `sentiments` object[], required
    - `sentiment` string, nullable, required
    - `count` number, required
    - `percentage` number, required
  - `trends` object[], required
    - `date` string, required
    - `count` number, required
  - `knowledge_references` object[], required
    - `type` 'ai_profile' | 'instruction' | 'knowledge' | 'prohibited_topic' | 'tool', required
    - `id` string, required
    - `count` number, required
  - `tool_references` object[], required
    - `type` 'ai_profile' | 'instruction' | 'knowledge' | 'prohibited_topic' | 'tool', required
    - `id` string, required
    - `count` number, required
  - `instruction_references` object[], required
    - `type` 'ai_profile' | 'instruction' | 'knowledge' | 'prohibited_topic' | 'tool', required
    - `id` string, required
    - `count` number, required
  - `prohibited_topic_references` object[], required
    - `type` 'ai_profile' | 'instruction' | 'knowledge' | 'prohibited_topic' | 'tool', required
    - `id` string, required
    - `count` 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)