APIOfficial product category

Get official product categories

GET
/public/v1/official-product-categories

List Distru's official product categories — the global, system-defined reference taxonomy (e.g. FLOWER, PRE_ROLL, EDIBLE) that is identical for every company and is not scoped to your API key. These records are singletons maintained by Distru; they cannot be created, edited, or deleted through the API.

Use this to resolve the official_product_category_id on your own product categories: each of your product categories maps to exactly one of these, and that mapping is what lets Distru report across accounts, drive consistent menu/marketplace filtering, and let buyers configure POS integrations without knowing your custom category names. Fetch this list to discover the valid category id values before you set that mapping; you do not need it for anything else.

The full set is returned in a single call ordered by id ascending — there is no filtering, no pagination, and no next_page. The list is small and stable, so it is safe to cache; new entries are added only when Distru extends the taxonomy.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Response Body

A list of official product categories

*/*
  1. response

A collection of official product categories

data?array<>

OfficialProductCategories

next_page?string

URL for the next page of results; null when there is no next page

Example Request
curl -X GET 'https://app.distru.com/public/v1/official-product-categories'
Example Response
{  "data": [    {      "id": "CAPSULES",      "name": "Capsules"    },    {      "id": "CLONES",      "name": "Clones & Seeds"    },    {      "id": "CONCENTRATES",      "name": "Concentrates"    },    {      "id": "EDIBLES",      "name": "Edibles"    },    {      "id": "FLOWER",      "name": "Flower"    },    {      "id": "MERCH",      "name": "Merch"    },    {      "id": "OTHER",      "name": "Other"    },    {      "id": "PREROLLS",      "name": "Pre-Rolls"    },    {      "id": "TINCTURES",      "name": "Tinctures"    },    {      "id": "TOPICALS",      "name": "Topicals"    },    {      "id": "VAPES",      "name": "Vapes"    }  ]}