> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a tag

> Read a tag's editable fields, including tags with no answers yet, and the ETag you need to update or delete the tag with the If-Match header.

Returns the tag configuration, including labels with no answers. Read
access is available from Growth and Agency Growth.

**Authorization** `string` *required*

Bearer token for your team.

**brandId** `string` *required*

Workspace identifier. The workspace must belong to the token's team.

**tagId** `string` *required*

Tag identifier within this workspace.

## Response

Returns `200`, the resource `ETag`, and `Cache-Control: private, no-store`.
The `tag` object contains `id`, `name`, nullable `color`,
`version`, `createdAt` and `updatedAt`. Dates are ISO 8601 strings.
Copy the ETag into `If-Match` for an [update](https://docs.qwairy.co/developers/endpoints/tags/update.md)
or [deletion](https://docs.qwairy.co/developers/endpoints/tags/delete.md).

## Synthetic request and response

```bash theme={null}
curl -i "https://www.qwairy.co/api/v1/brands/$BRAND_ID/tags/$TAG_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "success": true,
  "tag": {
    "id": "22222222-0000-4000-8000-000000000000",
    "name": "Pricing",
    "color": "#7B3AEE",
    "version": 4,
    "createdAt": "2026-09-01T09:00:00.000Z",
    "updatedAt": "2026-09-01T10:00:00.000Z"
  }
}
```

## Errors

An inaccessible workspace returns `404 BRAND_NOT_FOUND`; a missing tag
returns `404 TAG_NOT_FOUND`. A resource in another team
is indistinguishable from a missing resource. See [Error codes](https://docs.qwairy.co/developers/errors.md)
and honor `Retry-After` on `429`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.