---
title: "Retrieve item groups"
method: GET
path: "/v2/item_groups"
tags: ["Item groups"]
---

# Retrieve item groups

`GET /v2/item_groups`

**🔐 This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).**
For authenticating with Bearer token, required scopes are: `catalog(r)`.

Retrieve all items groups, optionally filtered by ids.

## Query parameters

- `key` string, required — The key of the index to use.
- `id` string[] — Array of item group ID(s) to filter by.
- `num_results_per_page` integer — The number of results per page to return.
- `page` integer — The page of results to return.
- `offset` integer — The number of results to skip from the beginning. Cannot be used together with `page`.
- `c` string — The ID of the client and version that the request is coming from, such as `cio-js-2.90`.

## Response `200`

OK

- ItemGroupsListGetResponse
  - `item_groups` ItemGroupsGetResponse[], required
    - `data` object — Object containing additional data, that should be attached to this item group. The maximum size of data object is limited to 5kB. The average size of data objects for all ingested item groups should not exceed 1kB.
    - `id` string, required — The ID of the item group
    - `name` string, required — Item group display name.
    - `parent_ids` string[] — List of parent item group IDs
  - `total_count` integer, required — Total number of item groups.

## Other responses

- `400` — Validation Error
- `401` — Credentials are not passed or action is forbidden.
- `403` — The supplied token does not have the required permissions.
- `429` — Rate limit breached

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)