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

# ✨ Get label distribution structure

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

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

## Path parameters

- `id` integer, required

## Response `200`

Label distribution structure

- LabelDistributionStructureResponse
  - `choice_keys` string[], required — All project choice keys in stable order, joined with "___PIPE___" when passed as query param.
  - `dimensions` LabelDistributionStructureDimension[], required
    - `choice_keys` string[], required — Flat keys in "<from_name>___SEP___<choice>" format for this dimension.
    - `choices` string[], required — Sorted list of choices observed from config and/or created labels.
    - `dimension_id` integer — Dimension primary key used by Dimension-backed Data Manager result filters.
    - `name` string, required — Original from_name from labeling config or observed annotation results.
    - `type` string — Result item type for this dimension when available.
    - `unsupported_reason` string — Reason this dimension cannot render label distribution rows, when unavailable.

---

[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/revisions/1b113b8df950/schema)