---
title: "List Tags"
method: GET
path: "/api/v1/tag"
tags: ["Tags"]
---

# List Tags

`GET /api/v1/tag`

Get a list of tags. No filtering is currently available.

## Response `200`

List of tags.

- object
  - `links` object — Indicates Links to associated pages.
    - `next` string — The link to the next page (null if there are no more pages).
    - `previous` string — The link to the previous page (null if on the first page).
  - `meta` object — Reprents the meta data of the response.
    - `page` integer — The current page number.
    - `previous_page` integer — The previous page number (null if on the first page).
    - `next_page` integer — The next page number (null if on the last page).
  - `count` integer — The total count of items returned.
  - `total_pages` integer — The total number of pages.
  - `results` V1TagsResponse[]
    - `id` string — The unique identifier of the resource.
    - `created_at` string, date-time — The timestamp when the resource was created in Secoda in UTC format.
    - `updated_at` string, date-time — The timestamp when the resource was last updated in Secoda in UTC format.
    - `name` string — Indicates the name of the tag.
    - `description` string — Indicates the description of the tag.
    - `color` string — Defines the different colors of the tags in HEX format.
    - `integration_id` string — The unique identifier of the integration the tag is pulled from. Null if the tag is created manually in Secoda.
    - `workspace_id` string — Indiactes the workspace ID where the tag belongs.

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

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