---
title: "List chat session history"
method: GET
path: "/chat/sessions/{session_id}/history"
---

# List chat session history

`GET /chat/sessions/{session_id}/history`

Returns a paginated list of events (messages, handoffs, status changes, etc.) for a chat session.

## Path parameters

- `session_id` string, required

## Query parameters

- `cursor` string

## Response `200`

Default Response

- ListChatHistoryOutput
  - `items` ChatHistoryOutput[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `event` union, required
      - object
        - `type` 'message', required
        - `sender` union, required
          - object
            - `type` 'contact', required
            - `name` string
          - object
            - `type` 'ai', required
            - `name` string
          - object
            - `type` 'human_agent', required
            - `name` string
        - `content` object, required
          - `type` 'text', required
          - `text` string, required
        - `context` object
        - `attachments` PublicChatAttachment[], required
          - `id` string, required
          - `name` string, required
          - `size` number, required
          - `type` string, required
          - `url` string, required
      - object
        - `type` 'workflow_message', required
        - `workflow_id` string, nullable, required
        - `workflow_run_id` string, nullable, required
        - `content` object, required
          - `type` 'text', required
          - `text` string, required
      - object
        - `type` 'sequence_message', required
        - `sequence_id` string, nullable, required
        - `content` object, required
          - `type` 'text', required
          - `text` string, required
      - object
        - `type` 'handoff', required
        - `integration` object
          - `type` 'zendesk' | 'salesforce-miaw', required
      - object
        - `type` 'closed_resolved_by_agent', required
      - object
        - `type` 'closed_resolved_by_system', required
      - object
        - `type` 'closed_resolved_by_api', required
      - object
        - `type` 'closed_unresolved_by_agent', required
      - object
        - `type` 'closed_unresolved_by_system', required
      - object
        - `type` 'closed_unresolved_by_api', required
      - object
        - `type` 'closed_resolved_by_contact', required
      - object
        - `type` 'closed_resolved_by_integration', required
      - object
        - `type` 'sub_status_set_by_agent', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_set_by_system', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_set_by_api', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_removed_by_agent', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_removed_by_system', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_removed_by_api', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_set_by_integration', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'sub_status_removed_by_integration', required
        - `sub_status_id` string, nullable, required
      - object
        - `type` 'tag_added_by_system' | 'tag_added_by_agent' | 'tag_added_by_api' | 'tag_added_by_integration' | 'tag_removed_by_system' | 'tag_removed_by_agent' | 'tag_removed_by_api' | 'tag_removed_by_integration', required
        - `tags` object[], required
          - `name` string, required
      - object
        - `type` 'ai_resolved_issue', required
      - object
        - `type` 'ai_assumed_issue_resolved', required
      - object
        - `type` 'user_confirmed_issue_resolved', required
      - object
        - `type` 'human_agent_comment', required
        - `human_agent_id` number, required
        - `content` object, required
          - `type` 'text', required
          - `text` string, required
        - `comment_thread_id` string, uuid, nullable, required
      - object
        - `type` 'human_agent_joined', required
        - `human_agent_id` number, required
      - object
        - `type` 'human_agent_takeover', required
        - `human_agent_id` number, required
      - object
        - `type` 'human_agent_reopened_session', required
        - `human_agent_id` number, required
      - object
        - `type` 'system_reopened_session', required
        - `workflow_id` string, nullable, required
        - `workflow_run_id` string, nullable, required
      - object
        - `type` 'integration_reopened_session', required
      - object
        - `type` 'ai_reopened_session', required
      - object
        - `type` 'state_checkpoint', required
        - `payload` unknown, required
      - object
        - `type` 'csat_requested', required
      - object
        - `type` 'csat_submitted', required
        - `payload` object, required
          - `score` number, required
          - `feedback` string, nullable, required
      - object
        - `type` 'agent_changed', required
      - object
        - `type` 'prohibited_topic_detected', required
        - `topic` string, nullable, required
      - object
        - `type` 'agent_assigned_by_system', required
        - `assigned_agent_id` number
      - object
        - `type` 'agent_assigned_by_integration', required
        - `assigned_agent_id` number
      - object
        - `type` 'agent_assigned_by_user', required
        - `assigned_agent_id` number
        - `actor_id` number
      - object
        - `type` 'agent_unassigned_by_system', required
        - `unassigned_agent_id` number
      - object
        - `type` 'agent_unassigned_by_integration', required
        - `unassigned_agent_id` number
      - object
        - `type` 'agent_unassigned_by_user', required
        - `unassigned_agent_id` number
        - `actor_id` number
      - object
        - `type` 'team_assigned_by_system', required
        - `assigned_team_id` string
      - object
        - `type` 'team_assigned_by_integration', required
        - `assigned_team_id` string
      - object
        - `type` 'team_assigned_by_user', required
        - `assigned_team_id` string
        - `actor_id` number
      - object
        - `type` 'team_unassigned_by_system', required
        - `unassigned_team_id` string
      - object
        - `type` 'team_unassigned_by_integration', required
        - `unassigned_team_id` string
      - object
        - `type` 'team_unassigned_by_user', required
        - `unassigned_team_id` string
        - `actor_id` number
      - object
        - `type` 'sla_applied_by_system' | 'sla_applied_by_agent' | 'sla_removed_by_agent' | 'sla_removed_by_system' | 'sla_first_reply_metric_started' | 'sla_first_reply_fulfilled' | 'sla_first_reply_breached' | 'sla_first_reply_completed_after_breach' | 'sla_next_reply_metric_started' | 'sla_next_reply_fulfilled' | 'sla_next_reply_breached' | 'sla_next_reply_completed_after_breach' | 'sla_resolution_metric_started' | 'sla_resolution_paused_waiting_on_customer' | 'sla_resolution_paused_resolved' | 'sla_resolution_resumed_customer_replied' | 'sla_resolution_resumed_reopened' | 'sla_resolution_fulfilled' | 'sla_resolution_breached' | 'sla_resolution_completed_after_breach' | 'sla_freezed_office_hours_ended' | 'sla_resumed_office_hours_started' | 'sla_freezed_snoozed' | 'sla_resumed_snooze_expired' | 'sla_resumed_snooze_cancelled', required
        - `elapsed_ms` number, nullable, required
      - object
        - `type` 'workflow_triggered', required
        - `workflow_id` string, nullable, required
        - `workflow_run_id` string, nullable, required
      - object
        - `type` 'contact_data_updated', required
        - `fields` object, required
  - `next` string, nullable, 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)