---
title: "Obtain QXscores for a test"
method: GET
path: "/api/v2/testResults/{testId}/qxScores"
tags: ["QXscore Data"]
---

# Obtain QXscores for a test

`GET /api/v2/testResults/{testId}/qxScores`

Calculates the Quality of Experience Score (QXscore) for an [Interaction test](https://help.usertesting.com/hc/en-us/articles/23596817555101-Interaction-tests) based on all completed sessions. The response includes detailed component and subcomponent values that contribute to the overall QXscore.
    
   _Compatibility:_
  - Compatible with interaction tests, i.e., tests with the "STUDYV2" type and "NON_THINK_OUT_LOUD" product type.
  - Go to [How to Obtain a Test ID (UUID)](https://developer.usertesting.com/docs/how-to-obtain-a-testid-uuid) for details.

  _Note:_
  - A _QXscore_ is a reliable benchmark metric for evaluating the quality of an experience. This composite score combines behavioral data from navigation tasks with attitudinal data from a standardized questionnaire to effectively balance participants' actions and opinions.  
  [Learn more about QXscore](https://help.usertesting.com/hc/en-us/articles/22818008129565-QXscore).
 
  _Use case example:_
  - For an example on how to create a UX metrics dashboard with QXscore to track experience quality, go to [Build a UX Metrics Dashboard](https://developer.usertesting.com/v2.0/docs/ux-metrics-dashboard).

## Path parameters

- `testId` string, uuid, required

## Response `200`

QXscore successfully returned.

- QxScoreResponseApi
  - `testId` string, required — UUID of the test.
  - `qxScores` QxScoreItemDto[], required — List of QXscore results for each QX task group within the test.
    - `taskGroupId` string, required — UUID of a QX task group within the test that contains a set of navigational tasks and questions used to measure to the QXscore.
    - `label` string, required — Label for the QX task group.
    - `qxScore` number, nullable, required — The aggregate score computed from all sessions (participants) that completed the QX task group within the test.
    - `components` QxScoreComponentsDto, required
      - `behavioral` number, nullable, required — The average percentage obtained from sessions (participants) of the QXscore's behavioral component.
      - `attitudinal` number, required — The average percentage obtained from sessions (participants) of the QXscore's attitudinal component.
    - `values` QxScoreValuesDto, required
      - `behavioral` number[], nullable, required — Array that represents the navigational task scores used to calculate the behavioral component.
      - `usability` number, required — Represents the usability score used to calculate the attitudinal component.
      - `trust` number, required — Represents the trust score used to calculate the attitudinal component.
      - `appearance` number, required — Represents the appearance score used to calculate the attitudinal component.
      - `loyalty` number, required — Represents the loyalty score used to calculate the attitudinal component.
  - `meta` QxScoreMetaDto, required
    - `totalQxTasks` number, required — Total number of QX task groups.
    - `completes` number, required — Number of completed sessions.

## Other responses

- `401` — Missing or invalid access token.
- `404` — Test 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)