---
title: "Retrieve session details (v3)"
method: GET
path: "/api/v3/sessionResults/{sessionId}"
tags: ["General Session Data"]
---

# Retrieve session details (v3)

`GET /api/v3/sessionResults/{sessionId}`

Returns detailed information about a session, including participant demographics, task-group metadata, and individual task responses.

  _Compatibility:_
  - All sessions found within tests with the "STUDYV2" type are compatible. These include tests from the following product types:
    - "SURVEY" (survey)
    - "LIVE_CONVERSATION" (non-classic live conversation)
    - "NON_THINK_OUT_LOUD" (interaction test)
    - "THINK_OUT_LOUD" (think-out-loud test)
  - Go to [How to Obtain a Test ID (UUID)](https://developer.usertesting.com/docs/how-to-obtain-a-testid-uuid) for details.

  _Use case examples:_
  - For an example on how to understand and model session-level details and participant demographics, go to [Model Session Details & Demographics](https://developer.usertesting.com/v2.0/docs/understand-and-model-session-details-demographics).
  - For an example on how to add session details into an automated research data pipeline, go to [Create an Automated Pipeline](https://developer.usertesting.com/v2.0/docs/tutorial).
  - For an example on near real-time polling, go to [Stream Insights into Slack or Jira](https://developer.usertesting.com/v2.0/docs/stream-insights-into-slack-or-jira).

## Path parameters

- `sessionId` string, uuid, required

## Response `200`

Session details successfully retrieved.

- SessionResultsV3ResponseDto
  - `sessionId` string, uuid, nullable, required — ID of the session.
  - `audienceId` string, uuid, nullable, required — ID of the audience.
  - `testPlanId` string, uuid, nullable, required — ID of the test plan.
  - `sessionParticipant` SessionParticipantDto, required
    - `participantId` string, uuid, nullable, required — ID of the participant.
    - `demographicsInfo` DemographicInfoDto[], required — Demographic questions and answers.
      - `id` string, nullable, required — ID of the demographic question.
      - `code` string, nullable, required — Code or key identifying the demographic question category. For example: GENDER, AGE_GROUP, INTERESTS, or INCOME.
      - `label` string, nullable, required — Human-readable label for the demographic question.
      - `value` string, nullable, required — Answer(s) selected by the participant. Multiple values are separated by commas.
      - `type` 'DEMOGRAPHIC_QUESTION_TYPE_SINGLE' | 'DEMOGRAPHIC_QUESTION_TYPE_MULTIPLE' | 'UNRECOGNIZED', nullable, required — The question choice type. For example, single or multiple choice.
  - `taskGroups` TaskGroupItemDto[], required — List of task groups and their responses. May be empty if the session has no task groups.
    - `uuid` string, uuid, required — ID of the task group.
    - `type` 'QX_SCORE' | 'BALANCED_COMPARISON' | 'UNRECOGNIZED', required — Type of the task group.
    - `response` union, required — Type-specific response payload. Shape is determined by "type": - QX_SCORE → { score } - BALANCED_COMPARISON → { sequence }.
      - TaskGroupResponseQxScoreDto
        - `score` number, required — The participant's QXscore (0-100).
      - TaskGroupResponseBalancedComparisonDto
        - `sequence` string, required — Order in which the participant saw the comparison groups.
  - `tasks` TaskItemDto[], required — List of individual tasks and their responses. May be empty if the session has no tasks.
    - `uuid` string, uuid, required — ID of the task.
    - `text` string, required — Task prompt text.
    - `type` 'BLANK' | 'RATING_SCALE' | 'MULTIPLE_CHOICE' | 'IMAGE' | 'NPS' | 'URL' | 'RANK_ORDER' | 'WRITTEN' | 'FIGMA' | 'MATRIX' | 'UNRECOGNIZED', required — Type of the task. - BLANK: Simple placeholder task. Baseline for test creation. - RATING_SCALE: Likert-style rating scales. - MULTIPLE_CHOICE: Supports single-select and multi-select options. Includes multiSelect, randomizedOptions, and maxLimit metadata when available. - IMAGE: Displays an image in the study. Common in survey-style workflows. - NPS: Captures Net Promoter Score (0-10). - URL: Opens an external URL. - RANK_ORDER: Users rank options (for example: Chocolate, Strawberry, Vanilla, Mint Chocolate). - WRITTEN: Captures spoken responses (think-aloud). - FIGMA: Embeds interactive Figma prototypes. Metadata includes prototypeUrl, figmaPrototypeTitle, and figmaPrototypeDisplaySetting. - MATRIX: Grid-style question for rating multiple items.
    - `response` TaskResponseDataDto, required
      - `startTimeMs` number, required — Task start time (ms since session start).
      - `endTimeMs` number, required — Task end time (ms since session start).
      - `skipped` boolean, required — Whether the participant skipped the task.
      - `answer` TaskAnswerDto, required
        - `blank` object, nullable — Simple placeholder task. Baseline for test creation.
        - `ratingScale` object, nullable — Likert-style rating scales.
        - `multipleChoice` object, nullable — Supports single-select and multi-select options. Includes multiSelect, randomizedOptions, and maxLimit metadata when available.
        - `image` object, nullable — Displays an image in the study. Common in survey-style workflows.
        - `nps` object, nullable — Captures Net Promoter Score (0-10).
        - `url` object, nullable — Opens an external URL.
        - `rankOrder` object, nullable — Users rank options (for example: Chocolate, Strawberry, Vanilla, Mint Chocolate).
        - `written` object, nullable — Captures spoken responses (think-aloud).
        - `figma` object, nullable — Embeds interactive Figma prototypes. Metadata includes prototypeUrl, figmaPrototypeTitle, and figmaPrototypeDisplaySetting.
        - `matrix` object, nullable — Grid-style question for rating multiple items.

## Other responses

- `401` — Missing or invalid access token.
- `404` — Session not found.
- `429` — Too many requests. Maximum of 10 requests per minute.

---

[API](https://skmtc.dev/usertesting/apis/results-api.md) · [All operations](https://skmtc.dev/usertesting/apis/results-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usertesting/results-api/revisions/8124f6985018/schema)