✨ Get label distribution structure | API Reference

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

{
  "choice_keys": [
    "label___SEP___neg",
    "label___SEP___pos",
    "quality___SEP___1",
    "quality___SEP___2",
    "quality___SEP___3",
    "quality___SEP___4",
    "quality___SEP___5"
  ],
  "dimensions": [
    {
      "choice_keys": [
        "label___SEP___neg",
        "label___SEP___pos"
      ],
      "choices": [
        "neg",
        "pos"
      ],
      "name": "label",
      "type": "choices"
    },
    {
      "choice_keys": [
        "quality___SEP___1",
        "quality___SEP___2",
        "quality___SEP___3",
        "quality___SEP___4",
        "quality___SEP___5"
      ],
      "choices": [
        "1",
        "2",
        "3",
        "4",
        "5"
      ],
      "name": "quality",
      "type": "rating"
    }
  ]
}

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

Returns dimensions and flattened choice_keys for a project. Use this response to drive paginated or targeted calls to the label distribution counts endpoint.

<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 dimensions and flattened `choice_keys` for a project. Use this response to drive paginated or targeted calls to the label distribution counts endpoint.

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

Response

Label distribution structure

choice_keyslist of stringsRead-only

All project choice keys in stable order, joined with “PIPE” when passed as query param.

dimensionslist of objects