# View Tag Group Endpoint

## Structure

### Tag Group

<table border="1" id="bkmrk-name-type-descriptio" style="border-collapse: collapse; width: 100%; height: 188.18px;"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Name**  
</td><td style="height: 29.7969px;">**Type**  
</td><td style="height: 29.7969px;">**Description**  
</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">`name`</td><td style="height: 46.5938px;">string</td><td style="height: 46.5938px;">The name of the tag group (e.g., Size or Colour)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">`reference`</td><td style="height: 29.7969px;">string</td><td style="height: 29.7969px;">The reference of the tag group</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">`show_in_filters`</td><td style="height: 46.5938px;">boolean</td><td style="height: 46.5938px;">Whether the tag group shows in filters on listings page</td></tr><tr style="height: 35.3984px;"><td style="height: 35.3984px;">`tags`</td><td style="height: 35.3984px;">array</td><td style="height: 35.3984px;">An array of [Tag](https://support.aerocommerce.com/books/api/page/view-tag-group-endpoint#bkmrk-tag) objects</td></tr></tbody></table>

### Tag

<table border="1" id="bkmrk-name-type-descriptio-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Type**  
</td><td>**Description**  
</td></tr><tr><td>`name`</td><td>string</td><td>The name of the tag (e.g., Small or Red)</td></tr><tr><td>`slug`</td><td>string</td><td>The slug of the tag, if not present it is auto-generated from name</td></tr><tr><td>`reference`</td><td>string</td><td>The reference of the tag</td></tr><tr><td>`image`</td><td>object</td><td>The image of the tag, see [Image](https://support.aerocommerce.com/books/api/page/view-tag-group-endpoint#bkmrk-image)</td></tr><tr><td>`has_slug`</td><td>boolean</td><td>Whether the tag has a slug or not</td></tr></tbody></table>

### Image

<table border="1" id="bkmrk-name-type-descriptio-2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col><col style="width: 33.3731%;"></col></colgroup><tbody><tr><td>**Name**  
</td><td>**Type**  
</td><td>**Description**  
</td></tr><tr><td>`url`</td><td>string</td><td>The url of the image</td></tr></tbody></table>

## Example Request

```
GET /api/tag-groups/{id|name}
```

## Example Response

```json
{
    "id": 1,
    "name": "Size",
    "reference": null,
    "show_in_filters": true,
    "tags": [
        {
            "id": 1,
            "name": "Small",
            "reference": null,
            "slug": "small",
            "image": {
                "url": null
            },
            "has_slug": true
        }
    ]
}
```