---
title: "List sessions"
method: GET
path: "/v2/agents/sessions"
tags: ["Agents Sessions V2"]
---

# List sessions

`GET /v2/agents/sessions`

List the user's sessions, with optional agent and
time-range filters.

## Query parameters

- `agent_id` string
- `from` string
- `to` string
- `limit` number, double
- `token` string

## Response `200`

OK

- ListSessionsResponse
  - `sessions` SessionSummaryDto[], required
    - `id` string, required
    - `agent_id` string, required
    - `agent` SessionAgentDto
      - `name` string
      - `description` string
      - `presenter_type` string
      - `use_case` 'd-id-campaigns' | 'd-id-agents' | 'd-id-agentic-videos'
    - `user_id` string, required
    - `start_time` string, required
    - `duration_minutes` number, double
    - `insights` SessionInsightsDto
      - `headline` string
      - `outcome` 'Achieved' | 'Partially achieved' | 'Not achieved' | 'Unclear-definition'
      - `visual_analysis` string
      - `exit_status` string
    - `region` string
    - `message_count` number, double
    - `rating` number, double — End-of-call star rating (1–5), when the user submitted feedback.
  - `token` string

## Other responses

- `401` — AuthorizationError

---

[API](https://skmtc.net/d-id/apis/realtime-endpoints.md) · [All operations](https://skmtc.net/d-id/apis/realtime-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-id/realtime-endpoints/versions/2f2425e1b6b6/schema)