---
title: "Retrieve tag groups for a company or an organisation"
method: GET
path: "/v0/tag-groups"
tags: ["tag-groups"]
---

# Retrieve tag groups for a company or an organisation

`GET /v0/tag-groups`

⚠️ Attention: either the `company_id` or the `organization_id` query parameter MUST be provided.
            If you supply both, the `company_id` will be used. If you supply neither, the request will fail.
            If you supply the `company_id`, the response will contain only the tag groups for that company. 
            If you supply the `organization_id`, the response will contain the tag groups for all companies in the organization.
            If you supply the `company_id` and the `organization_id`, the response will contain only the tag groups for the company.

## Query parameters

- `company_id` string, uuid — Enter the company ID whose tag groups you are searching for. Required if organization_id is not provided. If you enter both company_id and organization_id, the company_id is used to filter the tag groups.
- `organization_id` string, uuid — Enter the organization ID whose tag groups you are searching for. Required if company_id is not provided. If you enter both company_id and organization_id, the company_id is used to filter the tag groups.
- `include_archived` boolean
- `include_tags_count` boolean

## Response `default`

default response

---

[API](https://skmtc.net/pleo/apis/gjoll-api.md) · [All operations](https://skmtc.net/pleo/apis/gjoll-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pleo/gjoll-api/versions/c70cd21dc330/schema)