# Получение продаваемого товара по ID

Gets a sellable item by its ID.

  Note
    This API call returns generic item catalog data when used without
    authorization. Use authorization to retrieve
    personalized
    user data, such as limits and promotions associated with the item.
    To do this, pass the user JWT in the Authorization header.
    For more information about user JWT, see the Security block
    for this call.

Endpoint: GET /v2/project/{project_id}/items/id/{item_id}
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
    Example: 59080

  - `item_id` (string, required)
    ID предмета (артикул).
    Example: "259774"

## Query parameters:

  - `promo_code` (string)
    Уникальный код, чувствительный к регистру. Содержит буквы и цифры.
    Example: "WINTER2021"

  - `show_inactive_time_limited_items` (integer)
    Отображает предметы с ограниченным сроком действия, которые недоступны пользователю. Срок действия таких предметов еще не начался или уже истек.
    Example: 1

  - `additional_fields[]` (array)
    Список дополнительных полей. Эти поля будут указаны в ответе, если вы отправите их в своем запросе.
    Enum: "media_list", "order", "long_description", "custom_attributes", "item_order_in_group"

## Response 200 fields (application/json):

  - `attributes` (array)
    Список атрибутов и их значений, соответствующих товару. Может использоваться для фильтрации каталога.

  - `attributes.external_id` (string)
    Уникальный ID атрибута. external_id может содержать только строчные и заглавные латинские буквы, цифры, тире и подчеркивания.

  - `attributes.name` (object)
    Название атрибута.
    Example: "Genre"

  - `attributes.values` (array)

  - `attributes.values.external_id` (string)
    Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

  - `attributes.values.value` (string)
    Значение атрибута.
    Example: "Strategy"

  - `can_be_bought` (boolean)
    Если true, пользователь может купить товар.
    Example: true

  - `custom_attributes` (object)
    JSON-объект, содержащий атрибуты товара и их значения.

  - `description` (string)
    Описание товара.
    Example: "Electric shield"

  - `groups` (array)
    Группы, к которым принадлежит товар.

  - `groups.external_id` (string)
    Уникальный ID группы. Используется для ссылок в запросах API или внешних системах.
    Example: "exclusive"

  - `groups.item_order_in_group` (integer)
    Позиция предмета внутри группы, определяющая порядок отображения.
Поле включается в ответ только при указании параметра в запросе additional_fields[].
    Example: 1

  - `groups.name` (string)
    Название группы.
    Example: "Exclusive"

  - `image_url` (string)
    URL-адрес изображения.
    Example: "https://cdn3.xsolla.com/img/misc/images/d2d6b1b517e6a7f3765c3bb5a3cfb87d.png"

  - `is_free` (boolean)
    Является ли товар бесплатным.

  - `item_id` (integer)
    Внутренний уникальный ID товара, который задается при создании товара.
    Example: 259774

  - `limits` (object,null)
    Ограничения на продажу товара.

  - `limits.per_item` (object,null)
    Ограничения на продажу для конкретного товара.

  - `limits.per_item.available` (integer)
    Оставшееся количество товара, которое могут приобрести все пользователи.
    Example: 3

  - `limits.per_item.total` (integer)
    Максимальное количество товара, которое могут приобрести все пользователи.
    Example: 5

  - `limits.per_user` (object,null)
    Ограничения на продажу товара для пользователя.

  - `limits.per_user.available` (integer)
    Оставшееся количество товара, которое может приобрести текущий пользователь.
    Example: 3

  - `limits.per_user.limit_exceeded_visibility` (string)
    Determines the visibility of the item in the catalog after the purchase limit is reached, until the next limit reset.

Applies to items for which recurring limit resets are configured in the recurrent_schedule array.

If limit resets are not configured, the item doesn't appear in the catalog after the purchase limit is reached,
regardless of the limit_exceeded_visibility value.

Possible values:
- show — The item is returned in catalog retrieval API calls after the purchase limit is reached. In client-side
catalog retrieval API calls, once the limit is reached, the item is returned with the can_be_bought: false flag. The
next reset date is returned in reset_next_date.
- hide — The item is not returned in catalog retrieval API calls after the purchase limit is reached, until the
limit is reset.
    Enum: "show", "hide"

  - `limits.per_user.recurrent_schedule` (any)

  - `limits.per_user.total` (integer)
    Максимальное количество товара, которое может приобрести один пользователь.
    Example: 5

  - `name` (string)
    Название товара.
    Example: "Electric shield"

  - `price` (object)
    Цены на товар.

  - `price.amount` (string)
    Цена товара со скидкой.
    Example: "9.99"

  - `price.amount_without_discount` (string)
    Цена товара.
    Example: "9.99"

  - `price.currency` (string)
    Валюта, в которой указана цена товара. Трехбуквенный код в соответствии со стандартом [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `promotions` (array)
    Примененные акции для отдельных товаров в корзине. Массив возвращается, если:

* Скидочная акция настроена для отдельного товара.

* Используется промокод с настройкой Скидка на выбранные товары.

Если акции на уровне отдельных товаров не применялись, возвращается пустой массив.

  - `promotions.bonus` (array)

  - `promotions.bonus.bundle_type` (string)
    Тип товара бонусного бандла. Доступно только для бонусного товара типа bundle.
    Enum: "standard", "virtual_currency_package"

  - `promotions.bonus.image_url` (string)
    URL-адрес изображения бонусного бандла. Недоступно для типа бонусного товара physical_good.

  - `promotions.bonus.name` (string)
    Название бонусного товара. Недоступно для типа бонусного товара physical_good.

  - `promotions.bonus.quantity` (integer)

  - `promotions.bonus.sku` (string)

  - `promotions.bonus.type` (string)
    Тип бонусного товара.
    Enum: "virtual_good", "virtual_currency", "bundle", "physical_good", "game_key", "nft"

  - `promotions.date_end` (string,null)

  - `promotions.date_start` (string,null)

  - `promotions.discount` (object,null)

  - `promotions.discount.percent` (string,null)

  - `promotions.discount.value` (string,null)

  - `promotions.limits` (object)

  - `promotions.limits.per_user` (object)

  - `promotions.limits.per_user.available` (integer)

  - `promotions.limits.per_user.total` (integer)

  - `promotions.name` (string)

  - `sku` (string)
    Уникальный ID товара. Артикул может содержать только строчные и заглавные латинские буквы, цифры, точки, тире и подчеркивания.
    Example: "electric_shield"

  - `type` (string)
    Тип товара: virtual_good/virtual_currency/bundle/game_key/physical_good.
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good"

  - `virtual_item_type` (string)
    Type of virtual item.

Possible values:
- consumable — An item that disappears from the inventory after use (e.g., ammo).
- non_consumable — An item that stays in the inventory for an unlimited period of time.
- non_renewing_subscription — Time-limited item that can represent access to services or content for a limited period of time.
    Enum: "consumable", "non_consumable", "non_renewing_subscription"

  - `virtual_prices` (array)
    Виртуальные цены.

  - `virtual_prices.amount` (integer)
    Цена товара со скидкой в виртуальной валюте.
    Example: 10

  - `virtual_prices.calculated_price` (object)

  - `virtual_prices.calculated_price.amount` (string)

  - `virtual_prices.calculated_price.amount_without_discount` (string)

  - `virtual_prices.description` (string,null)
    Описание виртуальной валюты.

  - `virtual_prices.image_url` (string)
    Изображение виртуальной валюты.
    Example: "https://cdn3.xsolla.com/img/misc/images/e2e9ce8b00eb0190c161c4258b899101.png"

  - `virtual_prices.is_default` (boolean)
    Является ли данная цена товара ценой по умолчанию.
    Example: true

  - `virtual_prices.name` (string)
    Название виртуальной валюты.
    Example: "Gold"

  - `virtual_prices.sku` (string)
    Артикул виртуальной валюты.
    Example: "gold"

  - `virtual_prices.type` (string)
    Тип виртуальной валюты.
    Example: "virtual_currency"

  - `vp_rewards` (array)
    Стоимость призовых баллов товара.

  - `vp_rewards.amount` (integer)
    Количество призовых баллов.

  - `vp_rewards.is_clan` (boolean)
    Может ли призовой балл использоваться в цепочках наград для клана.

  - `vp_rewards.item_id` (integer)
    Внутренний уникальный ID виртуального предмета или валюты.

  - `vp_rewards.name` (string)
    Название призовых баллов.

  - `vp_rewards.sku` (string)
    Уникальный ID призовых баллов.

## Response 404 fields (application/json):

  - `errorCode` (integer)
    Example: 4001

  - `errorMessage` (string)
    Example: "[0401-4001]: Item with id = 259774 not found"

  - `statusCode` (integer)
    Example: 404