# Get item group by external ID filtered by item type

Retrieves an item group by external ID. Only items of the specified type are counted for the group. This is similar to the Get item group by external ID endpoint, with additional filtering of items by type when counting them.

Endpoint: GET /v2/project/{project_id}/admin/items/{item_type}/groups/{external_id}
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Project ID. You can find this parameter in your Publisher Account next to the project name and in the browser address bar when working with a project. The URL has the following format: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `item_type` (string, required)
    Item type used to filter groups. Determines which items are included in items_count. Values containing / (for example, virtual_currency/package or game/key) must be URL-encoded (for example, virtual_currency%2Fpackage).
    Enum: "virtual_items", "virtual_currency", "virtual_currency/package", "game/key", "bundle", "game", "value_points", "subscription_plans"

  - `external_id` (string, required)
    External item group ID specified during creation.
    Example: "weapons"

## Response 200 fields (application/json):

  - `description` (object,null)
    Object with localizations for group's description. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the [documentation](/zh/doc/shop-builder/references/supported-languages/).
    Example: {"en":"Player weapons"}

  - `external_id` (string, required)
    External item group ID specified during creation.
    Example: "weapons"

  - `id` (integer, required)
    Item group ID assigned by Xsolla.
    Example: 1

  - `image_url` (string,null)
    URL of the item group image.

  - `is_enabled` (boolean, required)
    Whether the item group is enabled in the catalog.

  - `items_count` (integer)
    Total number of items in the group.
    Example: 5

  - `name` (object, required)
    Object with localizations for group's name. Accepts value in one of two formats: two-letter lowercase language codes (e.g., en) or five-character locale codes (e.g., en-US). While both formats are accepted as input, responses return two-letter lowercase language codes. When both options for the same language are provided (e.g., en and en-US), the last provided value is stored. You can find the full list of supported languages in the [documentation](/zh/doc/shop-builder/references/supported-languages/).
    Example: {"en":"Weapons"}

  - `order` (any)

  - `is_contains_any_items` (boolean)
    Whether the group contains any items, regardless of the specified item_type. A group can have items_count: 0 for the specified type, while is_contains_any_items is true if the group contains items of other types.

## Response 401 fields (application/json):

  - `errorCode` (integer)
    错误代码。

  - `errorMessage` (string)
    Short error description.

  - `statusCode` (integer)
    HTTP response status.

  - `transactionId` (string)
    Request ID. The ID used to track and associate log entries related to this specific request or operation. This ID can be helpful for troubleshooting, debugging, and auditing purposes.

## Response 404 fields (application/json):

  - `errorCode` (integer)
    错误代码。

  - `errorMessage` (string)
    Short error description.

  - `statusCode` (integer)
    HTTP response status.

  - `transactionId` (string)
    Request ID. The ID used to track and associate log entries related to this specific request or operation. This ID can be helpful for troubleshooting, debugging, and auditing purposes.

  - `errorMessageExtended` (object,null)
    IDs used in the failed lookup.

  - `errorMessageExtended.external_id_list` (array)
    List of group external_id used in the lookup request.

  - `errorMessageExtended.group_id_list` (array)
    List of group id used in the lookup request.

  - `errorMessageExtended.project_id` (integer)
    Project ID used in the lookup request.