---
title: "Get Label Distribution"
method: GET
path: "/v1/analytics/taxonomies/{taxonomy_id}/labels"
tags: ["Analytics", "Analytics - Taxonomies"]
---

# Get Label Distribution

`GET /v1/analytics/taxonomies/{taxonomy_id}/labels`

Get label distribution.

Analyzes label usage including:
- Top labels by assignment count
- Label popularity percentages
- Confidence by label

**Use Cases:**
- Understand label usage
- Identify most common categories
- Balance taxonomy coverage

## Path parameters

- `taxonomy_id` string, required

## Query parameters

- `hours` integer
- `limit` integer

## Response `200`

Successful Response

- LabelDistributionResponse — Taxonomy label distribution response.
  - `taxonomy_id` string, required
  - `labels` LabelMetric[], required
    - `label` string, required
    - `count` integer, required
    - `percentage` number, required
    - `avg_confidence` number, required
  - `total_labels` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/5307993e44d3/schema)