# Get item group list

Gets an item group list for building a catalog.

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

## Path parameters:

  - `project_id` (integer, required)
    Project ID. You can find this parameter in your Publisher Account next to the name of the project.
    Example: 44056

## Query parameters:

  - `promo_code` (string)
    Unique case sensitive code. Contains letters and numbers.
    Example: "WINTER2021"

## Response 200 fields (application/json):

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

  - `groups.external_id` (string)
    External group ID.
    Example: "hair"

  - `groups.name` (string)
    Group name.
    Example: "Hair"

  - `groups.description` (string)
    Group description.
    Example: "Hair description"

  - `groups.image_url` (string,null)
    Image URL.

  - `groups.order` (integer)
    Defines arrangement order.
    Example: 1

  - `groups.level` (integer)
    Group nesting level.

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

  - `groups.children.image_url` (string,null)
    Group image URL.

  - `groups.children.parent_external_id` (string,null)
    Parent external group ID.
    Example: "hair"