---
search:
  tags:
    - Catalog
    - GET
seo:
  description: >-
    Returns aggregated product groups (collections, product types, vendors,
    tags) — a… Reference for the GET /product_groups endpoint in the Bolder API
    v2 API.
sidebar:
  badge: GET
  label: List product groups
title: List product groups
type: openapi-operation
---
Returns aggregated product groups (collections, product types, vendors, tags) — a
cross-collection discovery search, not CRUD on a real "product group" table.

Filtering:

- **`shop_id`** — scopes to that shop's seller.
- **`seller_id`** — scopes to that seller.
- Neither given — account-scoped, across all of the token's sellers.

`q` (substring match on name/slug) and `id` + `group_type` (direct lookup of a single
group; `group_type` is one of `collection`, `product_type`, `vendor`, `tag`) work the same
way under all three filters. Tags are only included in the `q` and `id`/`group_type`
results — the unfiltered/default listing (most-recently-updated) never includes tags.
Not paginated — only `per_page` applies (default 10, max 25); there is no `page` param.

<Operation source="v2" id="listproductgroups" />