---
title: "List all call tags"
method: GET
path: "/tags"
tags: ["tags"]
---

# List all call tags

`GET /tags`

Retrieves all tags defined for your team. Tags are labels that can be attached to calls for categorization and reporting purposes (e.g., "support", "sales", "follow-up"). Tags are team-wide — all users share the same tag set. The total count is in the `list_count` field.

**Permission:** `IVRs Read` required.

**Monitoring:** Not needed. All team tags are returned regardless of the Monitoring flag.

## Response `200`

Successful operation — returns the list of tags.

- TagList
  - `list_count` integer — The size of the list
  - `list` Tag[]
    - `tag_id` integer — The identifier of the tag
    - `name` string — The name of the tag
    - `color` 'ff6b6b' | 'F06292' | 'BA68C8' | '9575CD' | '7986CB' | '64B5F6' | '4FC3F7' | '4DD0E1' | '4DB6AC' | '81C784' | 'AED581' | 'DCE775' | 'FFD54F' | 'FFB74D' | 'FF8A65' | 'A1887F' | 'E0E0E0' | '90A4AE'
    - `description` string — The description of the tag
    - `creation_date` string, date-time

## Other responses

- `204` — No tags found.
- `401` — Unauthorized — invalid or missing API token, or missing `IVRs Read` permission.
- `500` — Internal server error.

---

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