# Weedmaps Public APIs Documentation > Documentation for Weedmaps Public APIs ## Guides - [Getting Started](https://developer.weedmaps.com/docs/onboarding-process.md): Onboarding Process - [Overview](https://developer.weedmaps.com/docs/overview.md) - [Authorization](https://developer.weedmaps.com/docs/oauth.md): Weedmaps utilizes the OAuth2 ClientCredentials Flow - [Obtaining An Access Token](https://developer.weedmaps.com/docs/obtaining-an-access-token.md) - [Making Authorized Requests](https://developer.weedmaps.com/docs/making-authorized-request.md) - [Rate Limits](https://developer.weedmaps.com/docs/rate-limits.md) - [Versioning](https://developer.weedmaps.com/docs/versioning.md) - [Keeping Up-To-Date](https://developer.weedmaps.com/docs/keeping-up-to-date.md) - [FAQ](https://developer.weedmaps.com/docs/faq.md): Frequently Asked Questions - [Error Handling](https://developer.weedmaps.com/docs/error-handling.md) - [Working with Images](https://developer.weedmaps.com/docs/working-with-images.md) - [Getting Started with the Menu API](https://developer.weedmaps.com/docs/wm-menu-api-getting-started.md) - [Brands](https://developer.weedmaps.com/docs/wm-brands.md) - [Brand Products](https://developer.weedmaps.com/docs/wm-brand-products.md) - [Menu Items](https://developer.weedmaps.com/docs/wm-menu-items.md): Menu Items represent the Listing's purchasable inventory item. - [Direct Management](https://developer.weedmaps.com/docs/direct-management.md) - [Indirect Management](https://developer.weedmaps.com/docs/indirect-management.md): Leverage external identifiers on Weedmaps - [Menu Item Enrichment](https://developer.weedmaps.com/docs/menu-item-enrichment.md) - [Link Cannabinoids to a Menu Item](https://developer.weedmaps.com/docs/link-cannabinoids-to-a-menu-item.md) - [Link Categories to a Menu Item](https://developer.weedmaps.com/docs/link-categories-to-a-menu-item.md) - [Link a Brand to a Menu Item](https://developer.weedmaps.com/docs/link-a-brand-to-a-menu-item.md) - [Link a Brand Product to a Menu Item](https://developer.weedmaps.com/docs/link-a-brand-product-to-a-menu-item.md) - [Link Terpenes to a Menu Item](https://developer.weedmaps.com/docs/link-terpenes-to-a-menu-item.md) - [Link a Strain to a Menu Item](https://developer.weedmaps.com/docs/link-a-strain-to-a-menu-item.md) - [Link Discovery Tags to a Menu Item](https://developer.weedmaps.com/docs/link-discovery-tags-to-a-menu-item.md) - [Menus](https://developer.weedmaps.com/docs/wm-menus.md): Represents a structured grouping of purchasable Menu Items available to an Organization. - [Taxonomy](https://developer.weedmaps.com/docs/taxonomy-1.md) - [Cannabinoids](https://developer.weedmaps.com/docs/wm-cannabinoids.md): Operations and Schemas - [Categories](https://developer.weedmaps.com/docs/wm-categories.md): Taxonomy - [Discovery Tags](https://developer.weedmaps.com/docs/wm-discovery-tags.md): Operations and Schemas - [Strains](https://developer.weedmaps.com/docs/wm-strains.md): Operations and Schemas - [Terpenes](https://developer.weedmaps.com/docs/wm-terpenes.md): Operations and Schemas - [Glossary](https://developer.weedmaps.com/docs/wm-glossary.md): Commonly used terms and business domain language used in the Guides - [Core Concepts and Structure](https://developer.weedmaps.com/docs/core-concepts-and-structure.md): Key business entities and their relationships - [Getting Started with the Orders API](https://developer.weedmaps.com/docs/getting-started-with-the-orders-api.md) - [Callbacks](https://developer.weedmaps.com/docs/callbacks.md) - [Configuring Order Callbacks](https://developer.weedmaps.com/docs/configuring-callbacks.md) - [Updating an Order](https://developer.weedmaps.com/docs/updating-an-order.md) - [Contact Us](https://developer.weedmaps.com/docs/contact-us.md) ## API Reference - [Retrieve Access Token](https://developer.weedmaps.com/reference/post_client_credentials.md): After a listing has added you as their integrator, you can request an access token using your client credentials. - [Retrieve Brands](https://developer.weedmaps.com/reference/get_brands.md): 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. --- - [Retrieve a Brand](https://developer.weedmaps.com/reference/get_brand_by_id.md): This operation will retrieve a Brand by its Weedmaps identifier. --- 💡 **Tip** 💡 When creating or updating a Menu Item, be sure to send us 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. --- - [Retrieve a Brand's Product Catalog](https://developer.weedmaps.com/reference/get_brand_products.md): This operation will retrieve a Brand's full catalog of Products. You can use the `sort` and `filter` query parameters to refine the results and locate specific Brand Products. --- 💡 **Tip** 💡 You can sync our catalog of Brand Products or map them to your internal Catalog. When creating or updating a Menu Item, be sure to send us the correlated Weedmaps identifier. This link can directly improve search relevance, increase consumer engagement, and it elevates the visibility of the Menu Item within the Weedmaps ecosystem. --- - [Retrieve a Brand Product](https://developer.weedmaps.com/reference/get_brand_products_by_id.md): This operation will retrieve a Brand Product using its Weedmaps Identifier. --- 💡 **Tip** 💡 You can sync our catalog of Brand Products or map them to your internal Catalog. When creating or updating a Menu Item, be sure to send us the correlated Brand Product identifier. This link can directly improve search relevance, increase consumer engagement, and it elevates the visibility of the Menu Item within the Weedmaps ecosystem. --- - [Retrieve Brand Product Reviews](https://developer.weedmaps.com/reference/get_reviews_by_product_id.md): This operation will retrieve the Brand Product's Reviews. The response includes customer reviews and operator responses for a Brand Product including submission date, ratings, review verification status, aggregate data and author information. - [Retrieve Menus](https://developer.weedmaps.com/reference/get_menus.md): This operation will retrieve all Menus that are linked to the Integrated Partner. You can use the `sort` and `filter` query parameters to refine the results and locate specific Menus. --- 💡 **Tip** 💡 The Menu response includes a nested `organization` object. You can use its `id` field (organization.id) with the `filters[organization_id]` query parameter to fetch all Menus belonging to that Organization. - [Retrieve a Menu](https://developer.weedmaps.com/reference/get_menu_by_id.md): This operation will retrieve a Menu that are linked to the Integrated Partner. - [Retrieve a Menu Item](https://developer.weedmaps.com/reference/get_menuitem_by_id.md): This operation will retrieve a singular Menu Item by its Weedmaps identifier. - [Delete a Menu Item](https://developer.weedmaps.com/reference/delete_menuitem_by_id.md): This operation will destroy a singular Menu Item by its Weedmaps identifier, and return the last representation of that Menu Item. - [Update a Menu Item](https://developer.weedmaps.com/reference/patch_menuitem_by_id.md): This operation will update an existing Menu Item by its Weedmaps identifier. - You can atomically sync Menu Items from your point-of-sale- adjusting price and inventory levels. - You can leverage this operation to enrich your Menu Items by linking a Brand, Brand Product, Strain, Categories, Cannabinoids, Discovery Tags, and Terpenes. --- 🚨 **Important** 🚨 A note on updating the `product_id` or `brand_id`: Manual Brand linking performed by retailers or Weedmaps—whether through our mutual client or curation services—are intentional and high-value. Do not overwrite these links, unless they have explicitly changed, and we urge you to send the replacement Weedmaps Brand identifier in its place. Overwriting manually linked products undermines the integrity of curated content and significantly reduces the effectiveness of our joint efforts. **You should only send attributes that have been changed on your end**. --- - [Retrieve a Menu's Menu Items](https://developer.weedmaps.com/reference/get_menuitems_by_menu_id.md): This operation will retrieve the Menu Items that are linked to the Menu that is identified by the path parameter. You can use the `sort` and `filter` query parameters to refine the results and locate specific Menu Items. - [Create a Menu Item](https://developer.weedmaps.com/reference/post_menu_items.md): This operation will create a Menu Item for a specific Menu identified in the `path parameter`. ⚠️ Always **store the `id`** from the creation response for future updates and deletions. Include Weedmaps **Categories (required), Cannabinoids, Strains, Discovery Tags**, and **Terpenes** to improve searchability and classification and overall Menu quality. --- ♻️ **Keeping our Systems Synced** * The `external_id` should uniquely identify a Menu Item. It must not be tied to a "batch" or inventory shipment, as those change frequently. * If the `external_id` changes (i.e., churns), Weedmaps will treat it as a new Menu Item. Even if it appears identical, it will lose all curated data—such as Brand links and Product attributes—previously applied through machine learning, manual merchandising, or the Weedmaps curation team. * The `external_product_id` can be used to help caching efforts for Brand Product Linking for the Menu Item. This attribute should reflect your internal brand product identifier. - [Upsert a Menu Item by External Identifier.](https://developer.weedmaps.com/reference/put_menuitem_by_externalid.md): This operation facilitates the Indirect Management strategy for Menu Items. * Use this operation with your internal ID as the reference. * Weedmaps creates the item if it doesn't exist or updates it if it does. * You receive the **same response structure** as Direct Management—containing all linked objects (brand, product, strain, tags, etc.). Include Weedmaps **Categories (required), Cannabinoids, Strains, Discovery Tags**, and **Terpenes** to improve searchability and classification and overall Menu quality. --- ♻️ **Keeping our Systems Synced** * The `external_id` should uniquely identify a Menu Item. It must not be tied to a "batch" or inventory shipment, as those change frequently. * If the `external_id` changes (i.e., churns), Weedmaps will treat it as a new Menu Item. Even if it appears identical, it will lose all curated data—such as Brand links and Product attributes—previously applied through machine learning, manual merchandising, or the Weedmaps curation team. * The `external_product_id` can be used to help caching efforts for Brand Product Linking for the Menu Item. This attribute should reflect your internal brand product identifier. --- 🚨 **Important** 🚨 A note on updating the `product_id` or `brand_id`: Manual Brand linking performed by retailers or Weedmaps—whether through our mutual client or curation services—are intentional and high-value. Do not overwrite these links, unless they have explicitly changed, and we urge you to send the replacement Weedmaps Brand identifier in its place. Overwriting manually linked products undermines the integrity of curated content and significantly reduces the effectiveness of our joint efforts. **You should only send attributes that have been changed on your end**. - [Delete a Menu Item by External Identifier.](https://developer.weedmaps.com/reference/delete_menuitem_by_externalid.md): This operation will destroy a singular Menu Item by its External identifier, and return the last representation of that Menu Item. - [Retrieve Cannabinoids](https://developer.weedmaps.com/reference/get_cannabinoids.md): This operation will retrieve all the Cannabinoids from the Weedmaps Catalog. You can use the `filter` query parameters to keep up-to-date with syncing Cannabinoids. --- 💡 **Tip** 💡 You can sync our catalog of Cannabinoids or map them to your internal Catalog. When creating or updating a Menu Item, be sure to send us the correlated Weedmaps identifier or slug. This link can directly improve search relevance, increase consumer engagement, and it elevates the visibility of the Menu Item within the Weedmaps ecosystem. --- - [Retrieve Categories](https://developer.weedmaps.com/reference/get_categories.md): 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. --- - [Retrieve the Root Categories and nested Sub-Categories](https://developer.weedmaps.com/reference/get_categoriestree.md): 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. --- - [Retrieve Strains](https://developer.weedmaps.com/reference/get_strains.md): This operation will retrieve Strains from the Weedmaps Catalog. You can use the `sort` and `filter` query parameters to refine the results and locate specific Strains. --- 💡 **Tip** 💡 You can sync our catalog of Strains or map them to your internal Catalog. When creating or updating a Menu Item, be sure to send us the correlated Strain identifier. This link can directly improve search relevance, increase consumer engagement, and it elevates the visibility of the Menu Item within the Weedmaps ecosystem. --- - [Retrieve Discovery Tags](https://developer.weedmaps.com/reference/get_tags.md): 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. --- - [Retrieve Terpenes](https://developer.weedmaps.com/reference/get-terpenes.md): This operation will retrieve Terpenes from the Weedmaps Catalog. You can use the `sort` and `filter` query parameters to refine the results and locate specific Terpenes. --- 💡 **Tip** 💡 You can sync our catalog of Terpenes or map them to your internal Catalog. When creating or updating a Menu Item, be sure to send us the correlated Terpene identifiers. This link can directly improve search relevance, increase consumer engagement, and it elevates the visibility of the Menu Item within the Weedmaps ecosystem. --- - [Retrieve Discounts](https://developer.weedmaps.com/reference/get_discounts.md): This operation will retrieve all of the available discounts for a Weedmaps Listing. - [Retrieve Order Schedule Time Windows](https://developer.weedmaps.com/reference/get_order_windows.md): This operation will retrieve the available time windows on a Listing's Order Schedule. - [Retrieve Document URL](https://developer.weedmaps.com/reference/get_user_documents.md): This operation will retrieve a short-lived resource URL for the given OrderDocument identifier. The Document identifier is the `order_id` and the `document_id` separated by double hyphens `--`: `{order_id}--{discount_id}`. - [Update Order Status](https://developer.weedmaps.com/reference/update_order_status.md): This operation will update the status of an Order. | Internal Status | Displayed to User | | ---------------------- | -------------------- | | `DRAFT` | Draft | | `PENDING` | New | | `IN_PROGRESS` | Preparing | | `READY_FOR_ATTAINMENT` | Ready for Attainment | | `COMPLETE` | Complete | | `CANCELED_CUSTOMER` | Canceled | | `CANCELED_SELLER` | Canceled | | `FAILED` | Failed | ## Changelog - [Order Status and Canceled Reason: 2026-01](https://developer.weedmaps.com/changelog/order-status-and-canceled-reason-2026-01.md) - [Cultivation Taxonomy Update](https://developer.weedmaps.com/changelog/cultivation-taxonomy-update.md) - [Version 2023-07 aka V1 Removal Update - Postponed](https://developer.weedmaps.com/changelog/version-2023-07-aka-v1-removal-update-postponed.md) - [Version Removed: 2023-07](https://developer.weedmaps.com/changelog/version-removed-2023-07-1.md) - [Version Deprecation: 2025-01](https://developer.weedmaps.com/changelog/version-deprecation-2025-01.md) - [Version Release 2025-07](https://developer.weedmaps.com/changelog/version-release-2025-07.md) - [Edibles, Drinks & Wellness & Vapes Taxonomy Update](https://developer.weedmaps.com/changelog/edibles-drinks-wellness-taxonomy-update.md) - [Menu Item page_size Fix](https://developer.weedmaps.com/changelog/menu-item-page_size-fix.md) - [Concentrate Taxonomy Update](https://developer.weedmaps.com/changelog/concentrate-taxonomy-update.md) - [Flower & Pre Roll Taxonomy Update](https://developer.weedmaps.com/changelog/flower-pre-roll-taxonomy-change.md)