# Get item group by external ID

Retrieves an item group by its external ID for administrative purposes.
NoteDo not use this endpoint for building a store catalog. Use the Get item group list client-side endpoint instead.

Endpoint: GET /v2/project/{project_id}/admin/items/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

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

## Response 200 fields (application/json):

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

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

  - `name` (object,null, 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](/doc/shop-builder/references/supported-languages/).

  - `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](/doc/shop-builder/references/supported-languages/).

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

  - `order` (integer)
    Display order of the item group in the catalog. The higher the value, the lower the group appears in the list. If the values are the same, groups are sorted by creation date, with newer groups displayed higher.

  - `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

## Response 401 fields (application/json):

  - `statusCode` (integer)
    HTTP response status.

  - `errorCode` (integer)
    Error code.

  - `errorMessage` (string)
    Short error description.

  - `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):

  - `statusCode` (integer)
    HTTP response status.

  - `errorCode` (integer)
    Error code.

  - `errorMessage` (string)
    Short error description.

  - `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.project_id` (integer)
    Project ID used in the lookup request.

  - `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.