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

# Retrieve Categories

`GET /categories`

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