# Получение списка групп товаров

Получает список групп товаров для создания каталога.

Endpoint: GET /v2/project/{project_id}/items/groups
Version: 2.0.0

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
    Example: 44056

## Query parameters:

  - `promo_code` (string)
    Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
    Example: "WINTER2021"

## Response 200 fields (application/json):

  - `groups` (array)
    Example: [{"children":[{"children":[{"children":[],"description":"Accessory","external_id":"accessory","image_url":null,"level":2,"name":"Accessory","order":1,"parent_external_id":"background"}],"description":"Background description","external_id":"background","image_url":null,"level":1,"name":"Background","order":1,"parent_external_id":"hair"}],"description":"Hair description","external_id":"hair","image_url":null,"level":0,"name":"Hair","order":1,"parent_external_id":null},{"children":[],"description":"Super description","external_id":"group_external_id","image_url":null,"level":0,"name":"Super","order":1,"parent_external_id":null}]

  - `groups.children` (array)
    Дочерние группы.
    Example: [{"children":[{"children":[],"description":"Accessory","external_id":"accessory","image_url":null,"level":2,"name":"Accessory","order":1,"parent_external_id":"background"}],"description":"Background description","external_id":"background","image_url":null,"level":1,"name":"Background","order":1,"parent_external_id":"hair"}]

  - `groups.children.description` (string)
    Описание группы.
    Example: "Background description"

  - `groups.children.external_id` (string)
    External ID группы.
    Example: "background"

  - `groups.children.image_url` (string,null)
    URL-адрес изображения группы.

  - `groups.children.level` (integer)
    Уровень вложенности группы.
    Example: 1

  - `groups.children.name` (string)
    Название группы.
    Example: "Background"

  - `groups.children.order` (integer)
    Определяет порядок расположения.
    Example: 1

  - `groups.children.parent_external_id` (string,null)
    Путь к каталогу (родительская папка группы).
    Example: "hair"

  - `groups.image_url` (string,null)
    URL-адрес изображения.