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

  - `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](/es/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](/es/doc/shop-builder/references/supported-languages/).
    Example: {"en":"Weapons"}

  - `order` (any)

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Código de error.

  - `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)
    Código de error.

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