---
title: "Retrieve the Root Categories and nested Sub-Categories"
method: GET
path: "/categories/tree"
tags: ["Taxonomy"]
---

# Retrieve the Root Categories and nested Sub-Categories

`GET /categories/tree`

This operation retrieves the Weedmaps Category Taxonomy as a tree; with the Root Categories and nested Sub-Categories.

---

**⚠️ Common Error**

A Menu Item can only have one root Category link.

This means that our system is receiving a Category identifiers that are in different taxonomy branches.

---

💡 **Tip** 💡

You can sync our taxonomy of Categories or map them to your internal Taxonomy.

When creating or updating a Menu Item, be sure to send us the correlated Weedmaps identifiers including the Sub-Categories.

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

---

## Response `200`

Successful Weedmaps Category Taxonomy Tree Retrieval

- object
  - `data` CategoryRoot[]
    - `id` integer, required — The primary identifier for a Weedmaps resource.
    - `name` string — The name that is displayed on a Weedmaps.
    - `published` boolean — This field controls the public visibility of on Weedmaps.
    - `slug` string — URL-safe slug for this resource; may be used in lieu of `id` when performing some operations.
    - `children` CategoryNodeLevel2[], required
      - `id` integer — The primary identifier for a Weedmaps resource.
      - `name` string — The name that is displayed on a Weedmaps.
      - `published` boolean — This field controls the public visibility of on Weedmaps.
      - `slug` string — URL-safe slug for this resource; may be used in lieu of `id` when performing some operations.
      - `children` array[]
        - CategoryNodeLevel3[]
          - `id` integer — The primary identifier for a Weedmaps resource.
          - `published` boolean — This field controls the public visibility of on Weedmaps.
          - `name` string — The name that is displayed on a Weedmaps.
          - `slug` string — URL-safe slug for this resource; may be used in lieu of `id` when performing some operations.
          - `children` unknown[]
            - unknown

## 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)