---
title: "List role-play sessions with pagination"
method: GET
path: "/api/v1/role-play-sessions"
tags: ["role-play-session"]
---

# List role-play sessions with pagination

`GET /api/v1/role-play-sessions`

## Query parameters

- `ids` string[], nullable
- `page` number
- `limit` number
- `orgId` string
- `userIds` string[]
- `missionReferenceIds` string[]
- `trackIds` string[]
- `state` 'PENDING' | 'PROCESSING' | 'DONE'
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `completedAfter` string, date-time
- `missionTitle` string
- `scorecardReferenceIds` string[]
- `order` object
  - `createdAt` 'ASC' | 'DESC'
  - `missionTitle` 'ASC' | 'DESC'
  - `score` 'ASC' | 'DESC'

## Response `201`

- RolePlaySessionFindResponseDTO
  - `data` object[], required
    - `analysis` object, required
      - `createdAt` string, date-time, required
      - `id` string, required
      - `items` object[], required
        - `behaviours` object[] — Array of behaviours assessed for this item
          - `evidence` string[], required — Evidence supporting the behaviour assessment
          - `score` number, required — The numerical score for this behaviour
          - `verdict` string, required — The verdict of the behaviour evaluation
        - `conversationItemReferenceId` string, nullable — Reference ID to the conversation item
        - `createdAt` string, date-time, required — The date and time when the item was created
        - `explanation` string, nullable — Explanation of the analysis result
        - `id` string, required — The unique identifier for the analysis item
        - `lastUpdatedAt` string, date-time, required — The date and time when the item was last updated
        - `name` string, nullable — The name of the analysis item
        - `score` number, required — The numerical score for this analysis item
        - `solved` 'undetected' | 'notSolved' | 'partlySolved' | 'solved' | 'null', nullable — The solving status of the item
        - `state` 'PROCESSING' | 'DONE' | 'ERROR', required — The current state of the analysis item
        - `suggestion` string, nullable — Suggestions for improvement
      - `lastUpdatedAt` string, date-time, required
      - `score` number, required
      - `state` 'PENDING' | 'PROCESSING' | 'DONE' | 'SKIPPED', required
    - `call` object, required
      - `assistantReferenceId` string, required — The reference ID for the assistant
      - `createdAt` string, date-time, required — The date and time when the call was created
      - `endedReason` string, nullable — The reason why the call ended
      - `id` string, required — The unique identifier for the call
      - `lastUpdatedAt` string, date-time, required — The date and time when the call was last updated
      - `providerCallId` string, nullable — The provider call identifier
      - `state` 'PENDING' | 'DONE' | 'DATA-NOT-AVAILABLE' | 'CAN-NOT-PROCESS-TRANSCRIPT', required — The current state of the call
      - `summary` string, nullable — A summary of the call
      - `transcript` string, nullable — The transcribed conversation text
    - `completed` boolean, required
    - `createdAt` string, date-time, required
    - `id` string, required
    - `kpis` object, required
      - `createdAt` string, date-time, required
      - `id` string, required
      - `lastUpdatedAt` string, date-time, required
      - `listenRatio` number, nullable
      - `longestMonologue` number, nullable
      - `state` 'PENDING' | 'PROCESSING' | 'DONE' | 'SKIPPED', required
      - `talkSpeed` number, nullable
    - `language` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'zh-Hans', required
    - `lastUpdatedAt` string, date-time, required
    - `missionReferenceId` string, nullable — Reference ID for the associated mission
    - `missionTitle` string, nullable
    - `playedLanguage` 'en' | 'de' | 'fr' | 'es' | 'it' | 'nl' | 'pl' | 'zh' | 'ja' | 'id' | 'tr' | 'pt' | 'el' | 'ko' | 'vi' | 'hi' | 'ms' | 'th' | 'hr' | 'ro' | 'bg' | 'sv' | 'no' | 'yue' | 'null', nullable
    - `scorecardReferenceId` string, nullable — Reference ID for the associated scorecard
    - `scorecardTitle` string, nullable — Title of the associated scorecard
    - `state` 'PENDING' | 'PROCESSING' | 'DONE', required
    - `trackId` string, nullable — Parent track id for mission-backed roleplay sessions
    - `trackTitle` string, nullable
    - `type` 'ROLE_PLAY', required
    - `userId` string, required
  - `meta` object, required
    - `hasNext` boolean, required
    - `limit` number, required
    - `page` number, required
    - `total` number, required

---

[API](https://skmtc.net/wejam/apis/jam.md) · [All operations](https://skmtc.net/wejam/apis/jam/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wejam/jam/revisions/bd5a5f406bca/schema)