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

# List all tags

`GET /tags`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/tags`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token` scopes: `global:user`

Returns every tag defined in the caller's tenant, both active and inactive, as an unpaginated array (no particular order is guaranteed). The tenant is taken from the access token, never from the request.

**Authorization:** requires the `global:user` scope.

Results are cached per tenant and the cache is evicted whenever tags are updated or deleted, so changes are visible immediately.

## Response `200`

All tags of the caller's tenant (possibly empty).

- TagValue[]
  - `tenantId` string, uuid
  - `agencyId` string, uuid
  - `createdDate` string, date-time
  - `createdBy` string, uuid
  - `creatorName` string
  - `lastModifiedDate` string, date-time
  - `lastModifiedBy` string, uuid
  - `version` integer
  - `id` string, uuid: Tag ID
  - `label` string: Display label (1-255 characters)
  - `active` boolean: Whether the tag is active (offered for selection)

## Other responses

- `403`: The token lacks the `global:user` scope.

---

[API](https://skmtc.dev/surense/apis/tags-api.md) - [All operations](https://skmtc.dev/surense/apis/tags-api/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/tags-api/revisions/90f42c1ba756?raw)