---
title: "Search Tags"
method: GET
path: "/tag"
tags: ["tags"]
---

# Search Tags

`GET /tag`

Search for Tags viewable by this user

## Query parameters

- `tagId` integer
- `tag` string
- `exactTag` string
- `isSystem` integer
- `isRequired` integer
- `haveOptions` integer
- `sortBy` 'tagId' | 'tag' | 'isSystem' | 'options' | 'isRequired'
- `sortDir` 'asc' | 'desc'

## Response `200`

successful operation

- Tag[]
  - `tagId` integer — The Tag ID
  - `tag` string — The Tag Name
  - `isSystem` integer — Flag, whether the tag is a system tag
  - `isRequired` integer — Flag, whether the tag requires additional values
  - `options` string, nullable — An array of options assigned to this Tag

## Changes

- **2026-07-30** `fe497e811c7f` — 2 info
  - added the new optional `query` request parameter `sortBy`
  - added the new optional `query` request parameter `sortDir`
- **2026-02-25** `41c04de98ec5` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2020-02-17** `8e1275395104` — 1 breaking
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/xibosignage/apis/xibo-api/changes/tag/get.md)

---

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