# Get Tag Group
Retrieve the tag group with the given tag group ID.
*Rate limits*:
Burst: `3/s`
Steady: `60/m`
**Scopes:**
`Tags Read`
# OpenAPI definition
```json
{
"openapi": "3.0.2",
"info": {
"title": "Klaviyo API",
"version": "2023-01-24",
"description": "The Klaviyo REST API. Please visit https://developers.klaviyo.com for more details.",
"contact": {
"name": "Klaviyo Developer Experience Team",
"email": "developers@klaviyo.com",
"url": "https://developers.klaviyo.com"
},
"termsOfService": "https://www.klaviyo.com/legal/api-terms",
"license": {
"name": "License",
"url": "https://www.klaviyo.com/legal"
}
},
"paths": {
"/api/tag-groups/{id}/": {
"get": {
"operationId": "get_tag_group",
"summary": "Get Tag Group",
"description": "Retrieve the tag group with the given tag group ID.
*Rate limits*:
Burst: `3/s`
Steady: `60/m`\n\n**Scopes:**\n`Tags Read`",
"parameters": [
{
"name": "id",
"required": true,
"description": "The Tag Group ID",
"schema": {
"type": "string",
"example": "zyxw9876-vu54-ts32-rq10-zyxwvu654321",
"description": "The Tag Group ID",
"default": "zyxw9876-vu54-ts32-rq10-zyxwvu654321"
},
"in": "path"
},
{
"name": "fields[tag-group]",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string",
"enum": [
"name",
"exclusive",
"default"
]
}
},
"in": "query",
"explode": false,
"description": "For more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#sparse-fieldsets"
},
{
"name": "revision",
"in": "header",
"required": true,
"description": "API endpoint revision (format: YYYY-MM-DD[.suffix])",
"schema": {
"type": "string",
"default": "2023-01-24"
}
}
],
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/GetTagGroupResponse"
}
}
}
},
"4XX": {
"$ref": "#/components/responses/ClientError",
"description": ""
},
"5XX": {
"$ref": "#/components/responses/ServerError",
"description": ""
}
},
"tags": [
"Tags"
],
"x-klaviyo-ratelimit": {
"burst": "3/s",
"steady": "60/m"
},
"x-klaviyo-scopes": [
"Tags Read"
],
"x-klaviyo-pre-release": "None"
}
}
},
"components": {
"schemas": {
"GetTagGroupResponse": {
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"type",
"id",
"attributes",
"links"
],
"properties": {
"type": {
"type": "string",
"enum": [
"tag-group"
]
},
"id": {
"type": "string",
"example": "zyxw9876-vu54-ts32-rq10-zyxwvu654321",
"description": "The Tag Group ID",
"default": "zyxw9876-vu54-ts32-rq10-zyxwvu654321"
},
"attributes": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "My Tag Group",
"description": "The Tag Group name",
"default": "My Tag Group"
},
"exclusive": {
"type": "boolean",
"description": "If a tag group is non-exclusive, any given related resource (campaign, flow, etc.) can be linked to multiple tags from that tag group. If a tag group is exclusive, any given related resource can only be linked to one tag from that tag group."
},
"default": {
"type": "boolean",
"description": "Every company automatically has one Default Tag Group. The Default Tag Group cannot be deleted, and no other Default Tag Groups can be created. This value is true for the Default Tag Group and false for all other Tag Groups."
}
},
"required": [
"name",
"exclusive",
"default"
]
},
"links": {
"$ref": "#/components/schemas/ObjectLinks"
}
}
}
}
},
"ObjectLinks": {
"type": "object",
"properties": {
"self": {
"type": "string",
"format": "uri"
}
},
"required": [
"self"
]
}
},
"responses": {
"ClientError": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"errors"
],
"properties": {
"errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"code",
"title",
"detail"
],
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string"
},
"title": {
"type": "string"
},
"detail": {
"type": "string"
},
"source": {
"type": "object",
"properties": {
"pointer": {
"type": "string"
},
"parameter": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"description": "Client Error"
},
"ServerError": {
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"errors"
],
"properties": {
"errors": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"code",
"title",
"detail"
],
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string"
},
"title": {
"type": "string"
},
"detail": {
"type": "string"
},
"source": {
"type": "object",
"properties": {
"pointer": {
"type": "string"
},
"parameter": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"description": "Server Error"
}
},
"securitySchemes": {
"Klaviyo-API-Key": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "Private key authentication for /api/ endpoints is performed by setting the `Authorization` header to `Klaviyo-API-Key your-private-api-key`
For more information please visit https://developers.klaviyo.com/en/v2023-01-24/reference/api-overview#authentication",
"x-default": "Klaviyo-API-Key your-private-api-key"
}
}
},
"servers": [
{
"url": "https://a.klaviyo.com",
"description": "Production"
}
],
"security": [
{
"Klaviyo-API-Key": []
}
],
"tags": [
{
"name": "Tags",
"description": "tags"
}
],
"x-readme": {
"explorer-enabled": false,
"proxy-enabled": true,
"samples-enabled": true
},
"_id": {
"buffer": {
"0": 99,
"1": 209,
"2": 144,
"3": 188,
"4": 105,
"5": 115,
"6": 190,
"7": 0,
"8": 46,
"9": 217,
"10": 40,
"11": 67
}
}
}
```