---
title: "✨ Get task agreement matrix"
method: GET
path: "/api/projects/{project_pk}/tasks/{task_pk}/agreement-matrix"
tags: ["Dimensions"]
---

# ✨ Get task agreement matrix

`GET /api/projects/{project_pk}/tasks/{task_pk}/agreement-matrix`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Returns a pairwise agreement matrix between selected participants for a single task, averaged across all active dimensions or a single specified dimension.

## Path parameters

- `project_pk` integer, required
- `task_pk` integer, required

## Query parameters

- `dimension` integer
- `selection` AgreementSelectionRequest, required
  - `annotators` AgreementSelectionGroupRequest
    - `all` boolean
    - `ids` string[]
  - `ground_truth` boolean
  - `models` AgreementSelectionGroupRequest
    - `all` boolean
    - `ids` string[]

## Response `200`

- TaskAgreementMatrixResponse
  - `matrix` array[], required — Pairwise agreement scores matrix where matrix[i][j] is the agreement between users[i] and users[j]
    - number[]
  - `users` object[], required — Expanded participant details (annotators and/or model versions)

## Changes

> 98 revisions in range; 1 not diffed.

- **2026-04-16** `ef7b273f70d8` — 1 breaking
  - the response property `matrix/items/items/` became nullable for the status `200`

[Change history](https://skmtc.dev/humansignal/apis/label-studio-api/changes/api/projects/:project_pk/tasks/:task_pk/agreement-matrix/get.md)

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/cbc94e6444bb/schema)