---
title: "Get list of tags"
method: GET
path: "/tags"
tags: ["Tags"]
---

# Get list of tags

`GET /tags`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/tags`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/tags/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paged list of all tags according to filters.

## Query parameters

- `pageCursor` string
- `pageSize` number
- `label` string
- `tagIds` string[]
- `includePendingApprovalsInfo` boolean
- `isProtected` boolean
- `type` TagType[]
- `allowedEntityType` string

## Response `200`

Tags fetched successfully

- TagsPagedResponse
  - `data` Tag[], required
    - `id` string, uuid, required: The unique identifier of the tag
    - `label` string, required: The tag label
    - `description` string: Description for the tag
    - `color` string: The tag color in hex format
    - `isProtected` boolean, required: Indication if the tag is a protected tag
    - `updatedAt` number, required: The date and time the tag was last updated
    - `type` 'WALLET_POOL': The tag type, indicating the domain that owns the tag
    - `allowedEntityTypes` string[]: The entity types this tag may be attached to. Tags created before this field was introduced read back as ['vault_account']. Known values: vault_account (default), contact.
    - `pendingApprovalRequest` ApprovalRequest: Approval request details
      - `id` string, numeric, required: The approval request identifier
      - `type` 'TAG_UPDATE' | 'TAG_DELETE' | 'TAG_ATTACH_DETACH', required: The approval request type
      - `state` 'PENDING' | 'APPROVED' | 'REJECTED' | 'FAILED' | 'CANCELLED' | 'EXPIRED', required: The approval request state
  - `next` string, nullable, required: Cursor to the next page

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)