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

# List tags

`GET /tags`

<small>Requires an API token with one of the following roles: **Document Reader**, **Template Reader**, or **Tag Manager**.</small>

Lists the tags defined for your account.

Tags are simple labels that can be assigned to [documents](/#documents) and [templates](/#templates).

## Sorting

To specify the order that tags should be returned in, use the `sort_by` and `sort_direction` query string
parameters.

For example, to sort by the `name` attribute in descending order, the query string should contain:
`sort_by=name&sort_direction=desc`

## Query parameters

- `sort_by` 'name', nullable
- `sort_direction` 'asc' | 'desc', nullable
- `page` integer, nullable
- `per_page` integer, nullable

## Response `200`

Paginated set of `TagResource`

- object
  - `data` TagResource[], required
    - `uuid` string, required
    - `name` string, nullable, required
    - `color` string, required — Hex color code for the color that the tag has been assigned
  - `links` object, required
    - `first` string, nullable, required
    - `last` string, nullable, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `meta` object, required
    - `current_page` integer, required
    - `from` integer, nullable, required
    - `last_page` integer, required
    - `links` object[], required — Generated paginator links.
      - `url` string, nullable, required
      - `label` string, required
      - `active` boolean, required
    - `path` string, nullable, required — Base path for paginator generated URLs.
    - `per_page` integer, required — Number of items shown per page.
    - `to` integer, nullable, required — Number of the last item in the slice.
    - `total` integer, required — Total number of items being paginated.

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `422` — Validation error

---

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