---
title: "Retrieve Categories"
method: GET
path: "/categories"
tags: ["Taxonomy"]
---

# Retrieve Categories

`GET /categories`

## Request

- Base URL: `https://api-g.weedmaps.com/wm/2025-07/partners`
- URL: `https://api-g.weedmaps.com/wm/2025-07/partners/categories`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api-g.weedmaps.com/wm/auth/token` scopes: `taxonomy:read`

This operation retrieves Categories from the Weedmaps Taxonomy. Results are returned in ascending order based on their Weedmaps identifier.

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

---
**⚠️ Common Error**

A Menu Item can only have one root Category link.

This means that our system is receiving Category identifiers that are in different Category 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.

---

## Query parameters

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

## Response `200`

Successful Categories Retrieval

- object
  - `data` Category[]
    - `id` integer: The primary identifier for a Weedmaps resource.
    - `name` string: The name that is displayed on a Weedmaps.
    - `parent_id` integer: Unique ID for this category's parent; category is the root when null
    - `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.
    - `updated_at` string: The timestamp this resource was last updated.
  - `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/menu-api.md) - [All operations](https://skmtc.dev/weedmaps/apis/menu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weedmaps/apis/menu-api/revisions/69a5b10f0082?raw)