---
title: "List Tag Groups"
method: GET
path: "/tag-groups"
tags: ["Project"]
---

# List Tag Groups

`GET /tag-groups`

List the user-defined tag groups of a project (distinct non-empty `group` values across the project's tags), each with its shared color and tag count. System groups (branding/intentType) are not included — see List Tags for those.

## Query parameters

- `project_id` string — Required if using a company api key

## Response `200`

Success

- object — Success
  - `data` object[], required
    - `group` string, required
    - `color` string, nullable, required — Shared color of every tag in the group
    - `tag_count` number, required — Number of tags in the group

---

[API](https://skmtc.net/peec/apis/peec-ai-customer-api.md) · [All operations](https://skmtc.net/peec/apis/peec-ai-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peec/peec-ai-customer-api/versions/92840a1bffa7/schema)