✨ Get label distribution counts | API Reference

curl http://localhost:8000/api/projects/1/stats/label-distribution/counts \
     -H "Authorization: Token  <api_key>"

{
  "results": [
    {
      "choice": "pos",
      "choice_key": "label___SEP___pos",
      "dimension_name": "label",
      "from_annotations_count": 12,
      "from_annotations_percent": 60,
      "from_predictions_count": 9,
      "from_predictions_percent": 45
    },
    {
      "choice": "neg",
      "choice_key": "label___SEP___neg",
      "dimension_name": "label",
      "from_annotations_count": 8,
      "from_annotations_percent": 40,
      "from_predictions_count": 11,
      "from_predictions_percent": 55
    }
  ],
  "totals": {
    "annotation_totals_by_dimension": {
      "label": 20
    },
    "prediction_totals_by_dimension": {
      "label": 20
    }
  }
}

This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise

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.

<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`.

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example:

curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

idintegerRequired

Query parameters

choice_keysstringOptional

Explicit choice keys to fetch, joined by “PIPE” (for example: “label___SEP___pos___PIPE___quality___SEP___4”). When provided, pagination params are ignored.

limitintegerOptional

Maximum number of choice keys to return for pagination. Ignored when choice_keys is provided.

offsetintegerOptionalDefaults to 0

Zero-based offset into the structure choice_keys list. Used only when choice_keys is not provided.

Response

Label distribution counts

next_offsetinteger or null

Next offset for pagination when using limit/offset mode; null when there are no more results or when filtering by explicit choice_keys.

resultslist of objects

totalsobject