---
title: "Retrieve Brands"
method: GET
path: "/brands"
tags: ["Brands"]
---

# Retrieve Brands

`GET /brands`

This operation will retrieve Brands from the Weedmaps Universal Brand Catalog.

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

---
💡 **Tip** 💡

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

When creating or updating a Menu Item, be sure to send back the correlated Brand identifier.

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[updated_at][before]` string, date-time

## Response `200`

Successful Brands Retrieval

- object
  - `data` Brand[]
    - `avatar_image_url` string, required — Avatar image for this Brand displayed on Weedmaps
    - `description` string, required — The description of this Brand displayed on Weedmaps
    - `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.
  - `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)