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

# List all tags

`GET /tags`

You can fetch a list of all tags for a given workspace.

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

successful

- TagList — A list of tags objects in the workspace.
  - `type` 'list' — The type of the object
  - `data` Tag[] — A list of tags objects associated with the workspace .
    - `type` string — value is "tag"
    - `id` string — The id of the tag
    - `name` string — The name of the tag
    - `applied_at` integer, nullable — The time when the tag was applied to the object. Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket.
    - `applied_by` Reference — reference to another object
      - `type` string
      - `id` string, nullable

## Other responses

- `401` — Unauthorized

## Changes

> 57 revisions in range; 7 could not be searched.

- **2026-02-10** (2.14) `788255ed5694` — 2 breaking, 2 warning, 1 info
  - the response property `data/items/applied_at` became nullable for the status `200`
  - the response property `data/items/applied_by` became nullable for the status `200`
  - removed the optional property `data/items/applied_by/id` from the response with the `200` status
  - removed the optional property `data/items/applied_by/type` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/intercom/apis/intercom-api/changes/tags/get.md)

---

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