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

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

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

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Code d'erreur.

  - `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)
    Code d'erreur.

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