---
title: "Retrieve Discovery Tags"
method: GET
path: "/tags"
tags: ["Taxonomy"]
---

# Retrieve Discovery Tags

`GET /tags`

This operation will retrieve Discovery Tags from the Weedmaps Catalog.

Each Tag belongs to a TagGroup, which groups similar product qualities, such as:

* Effects
* Flavors
* Material
* Dietary

You can use the `sort` and `filter` query parameters to refine the results and locate specific Discovery Tags.

---
💡 **Tip** 💡

You can sync our catalog of Discovery Tags or map them to your internal Catalog.

When creating or updating a Menu Item, be sure to send us the correlated Tag identifiers.

This link can directly improve search relevance, increase consumer engagement, and it elevates the visibility of the Menu Item within the Weedmaps ecosystem.

---

## Query parameters

- `page_size` integer
- `sort[]` string[]
- `filters[name][eq]` string
- `filters[name][match]` string
- `filters[published]` boolean
- `filters[group][ids][]` integer[]
- `filters[group][name][eq]` string
- `filters[group][name][match]` string
- `filters[updated_at][after]` string, date-time
- `filters[updated_at][before]` string, date-time

## Response `200`

Successful Discovery Tags Retrieval

- object
  - `data` Tag[]
    - `group` TagGroup
      - `id` integer, required — The primary identifier for a Weedmaps resource.
      - `name` string, required — The name that is displayed on a Weedmaps.
      - `updated_at` string, required — The timestamp this resource was last updated.
    - `id` integer, required — The primary identifier for a Weedmaps resource.
    - `name` string, required — The name that is displayed on a Weedmaps.
    - `published` boolean, required — This field controls the public visibility of on Weedmaps.
    - `updated_at` string, required — The timestamp this resource was last updated.
    - `slug` string, required — URL-safe slug for this resource; may be used in lieu of `id` when performing some operations.
  - `meta` Pagination — Pagination using page, per_page, and total to indicate the current page, number of items per page, and total number of items.
    - `page` integer — Current Page Number
    - `per_page` integer — Total Per Page
    - `total` integer — Total Number

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entities

---

[API](https://skmtc.dev/weedmaps/apis/auth-api.md) · [All operations](https://skmtc.dev/weedmaps/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/weedmaps/auth-api/revisions/7300ae412cb7/schema)