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

# List tags

`GET /tags`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/tags`
- Auth: HTTP bearer

Returns a paginated list of tags scoped to your team/account. Use the `query` parameter to search tag names.

## Query parameters

- `query` string
- `page` integer
- `limit` integer

## Response `200`

Default Response

- object
  - `success` boolean
  - `data` object
    - `tags` object[]
      - `id` string: Opaque tag identifier (tag_<32-hex>)
      - `name` string
    - `pagination` object
      - `page` number
      - `limit` number
      - `total` number
      - `totalPages` number

---

[API](https://skmtc.dev/pickfu/apis/pickfu-api.md) · [All operations](https://skmtc.dev/pickfu/apis/pickfu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickfu/apis/pickfu-api/revisions/919fc58413ea?raw)