---
title: "Get tag distribution"
method: GET
path: "/v1/stats/tag-repartition"
tags: ["Statistics"]
---

# Get tag distribution

`GET /v1/stats/tag-repartition`

Returns the distribution of contacts by tags applied after calls. Pass `workspaceId` to narrow to a single workspace within the API key scope. The legacy `teamId` parameter is still accepted but adds a `Deprecation: true` response header.

## Query parameters

- `sequenceId` string
- `userMembershipId` string
- `callType` 'all' | 'sequence' | 'direct' | 'inbound' | 'outbound'
- `granularity` 'hour' | 'day' | 'week' | 'month' | 'none'
- `startDate` string
- `endDate` string
- `workspaceId` string
- `teamId` string

## Response `200`

Tag distribution statistics

- TagRepartitionResponseDto
  - `data` TagRepartitionItemDto[], required
    - `tagId` string, required — Tag ID
    - `label` string, required — Tag label
    - `count` number, required — Number of contacts with this tag
    - `isSuccess` boolean, required — Whether this tag indicates success
    - `date` string — Date bucket (when granularity is not "none")

## Other responses

- `401` — Invalid or missing API key
- `403` — Requested workspaceId/teamId is outside the API key scope

---

[API](https://skmtc.dev/skipcall/apis/skipcall-public-api.md) · [All operations](https://skmtc.dev/skipcall/apis/skipcall-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/skipcall/skipcall-public-api/revisions/f594352719bd/schema)