---
title: "Get all tag groups"
method: GET
path: "/companies/{companyId}/tag-groups"
tags: ["tag-groups"]
---

# Get all tag groups

`GET /companies/{companyId}/tag-groups`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/tag-groups`
- Auth: HTTP bearer

Retrieve all tag groups for the company, including their tags.

The company must have the Tags feature enabled in their price plan.


**Scope:** `tags:read`

## Query parameters

- `page` integer
- `pageSize` integer
- `query` string

## Response `200`

Tag groups found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` TagGroup[]
    - `id` string, uuid: Unique identifier of the tag group
    - `name` string: Name of the tag group
    - `alias` string: Short alias for quick tagging (max 3 characters, unique per company)
    - `dimensionNumber` integer, nullable: Dimension number for SIE file export/import compatibility. Reserved numbers per SIE file format: 1 = Cost center, 2 = Cost carrier, 6 = Project, 7 = Employee, 8 = Customer, 9 = Supplier, 10 = Invoice, 20+ = Freely available.
    - `tags` TagValue[]: The tags (values) within this tag group
      - `id` string, uuid: Unique identifier of the tag
      - `name` string: Name of the tag

## Other responses

- `403`: Forbidden. The company's price plan does not include API access, or the integration does not have the required scope. See [price plan requirements](price-plan-requirements#handling-403-responses) for details on how to handle this response.

---

[API](https://skmtc.dev/bokio/apis/company-api.md) - [All operations](https://skmtc.dev/bokio/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/company-api/revisions/9395020f3da2?raw)