---
title: "✨ Get label distribution counts"
method: GET
path: "/api/projects/{id}/stats/label-distribution/counts"
tags: ["Stats"]
---

# ✨ Get label distribution counts

`GET /api/projects/{id}/stats/label-distribution/counts`

<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 counts and percentages for requested label choices, from both annotations and predictions. Supports either pagination (`limit`, `offset`) or targeted fetches via explicit `choice_keys`.

## Path parameters

- `id` integer, required

## Query parameters

- `choice_keys` string
- `limit` integer
- `offset` integer

## Response `200`

Label distribution counts

- LabelDistributionCountsResponse
  - `next_offset` integer, nullable, required — Next offset for pagination when using limit/offset mode; null when there are no more results or when filtering by explicit `choice_keys`.
  - `results` LabelDistributionCountsRow[], required
    - `choice` string, required
    - `choice_key` string, required
    - `dimension_name` string, required
    - `from_annotations_count` integer, required
    - `from_annotations_percent` number, double, required
    - `from_predictions_count` integer, required
    - `from_predictions_percent` number, double, required
  - `totals` LabelDistributionCountsTotals, required
    - `annotation_totals_by_dimension` object — Total annotation counts keyed by dimension name.
    - `prediction_totals_by_dimension` object — Total prediction counts keyed by dimension name.

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/versions/1b113b8df950/schema)