# Получение списка всех акций

Получает список акций проекта.

Endpoint: GET /v3/project/{project_id}/admin/promotion
Version: 2.0.0
Security: basicAuth

## Path parameters:

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

## Query parameters:

  - `limit` (integer)
    Лимит количества элементов на странице.
    Example: 50

  - `offset` (integer)
    Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

  - `enabled` (integer)
    Фильтрует элементы по флагу is_enabled.

## Response 200 fields (application/json):

  - `active_promotions_count` (integer)
    Количество активных акций.

  - `inactive_promotions_count` (integer)
    Количество отключенных акций.

  - `promotions` (array)

  - `promotions.bonus` (array)

  - `promotions.bonus.item` (object)

  - `promotions.bonus.item.bundle_type` (string)
    Тип бандла. Возвращается, если тип элемента является бандлом.
    Enum: "standard", "virtual_currency_package"

  - `promotions.bonus.item.content` (array)

  - `promotions.bonus.item.description` (string,null)
    Описание товара.
    Example: "Game description"

  - `promotions.bonus.item.image_url` (string,null)
    URL-адрес изображения.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `promotions.bonus.item.name` (object)
    Название товара.
    Example: {"en":"Game name"}

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

  - `promotions.bonus.item.type` (string)
    Тип товара: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `promotions.bonus.item.unit_items` (array)
    Если товар имеет тип unit, он включает в себя все товары в юните. В большинстве случаев пользователь должен выбрать один из них в качестве бонуса по купону.

  - `promotions.bonus.item.unit_items.drm_name` (string)
    Название платформы.
    Example: "Steam"

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

  - `promotions.bonus.item.unit_items.is_free` (boolean)

  - `promotions.bonus.item.unit_items.type` (string)
    Тип товара: game_key.
    Example: "game_key"

  - `promotions.bonus.quantity` (number)
    Количество товаров.

  - `promotions.condition` (array,null)

  - `promotions.discount` (object,null)
    Example: {"discount":{"percent":"10.99"}}

  - `promotions.discount.percent` (string,null)
    Процент скидки. 
Цена корзины будет уменьшена с использованием значения, рассчитанного с использованием этого процента, а затем округлена до 2 знаков после запятой.
    Example: "10.00"

  - `promotions.id` (integer)
    ID акции. Уникальный идентификатор акции в рамках проекта.
    Example: 1

  - `promotions.is_enabled` (boolean)

  - `promotions.limits` (object)
    Ограничения акции.

  - `promotions.limits.per_item` (integer,null)
    Глобальное ограничение товара.
    Example: 10

  - `promotions.limits.per_user` (object,null)
    Ограничение количества использований акций отдельным пользователем.

  - `promotions.limits.per_user.total` (integer)
    Общее количество единиц товара, которое может купить пользователь. Вы можете установить данное значение в Личном кабинете или использовать методы администратора для сущностей магазина (объект limits).
    Example: 5

  - `promotions.limits.recurrent_schedule` (object,null)
    Период обновления установленный ограничений.

  - `promotions.limits.recurrent_schedule.per_user` (object)
    Период обновления установленный ограничений для пользователя.

  - `promotions.limits.recurrent_schedule.per_user.day_of_month` (integer,null)
    День месяца, когда обновляются ограничения. Если в месяце нет указанного дня, поскольку месяц короче, обновление произойдет в последний день месяца. Не null только для периода monthly.

  - `promotions.limits.recurrent_schedule.per_user.day_of_week` (integer,null)
    День недели, когда обновляются ограничения: 1 — понедельник, 7 — воскресенье. Не null только для типа периода weekly.

  - `promotions.limits.recurrent_schedule.per_user.displayable_reset_next_date` (string)
    Дата и время, когда ограничения должны быть сброшены (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `promotions.limits.recurrent_schedule.per_user.displayable_reset_start_date` (string)
    Дата и время первого обновления ограничения (ISO 8601).
    Example: "2023-02-28T11:00:00+08:00"

  - `promotions.limits.recurrent_schedule.per_user.interval_type` (string)
    Период обновления ограничения на продажу товара.
    Enum: "daily", "weekly", "monthly"

  - `promotions.limits.recurrent_schedule.per_user.reset_next_date` (integer)
    Дата и время обновления ограничений (Unix Timestamp).
    Example: 1677553200

  - `promotions.limits.recurrent_schedule.per_user.time` (string)
    Время обновления ограничений в желаемом часовом поясе (округление до часов).
    Example: "11:00:00+03:00"

  - `promotions.name` (object)
    Название акции. Данный параметр должен содержать пары ключ/значение, 
где ключ — это локаль в формате "^[a-z]{2}-[A-Z]{2}$", значение — строка.
    Example: {"de-DE":"Gutscheintitel","en-US":"Coupon title"}

  - `promotions.promotion_periods` (array)
    Периоды действия акции. Если указано больше одного периода, параметры date_from и date_until становятся обязательными.

  - `promotions.promotion_periods.date_from` (string, required)
    Дата начала действия указанной акции.
    Example: "2020-08-11T10:00:00+03:00"

  - `promotions.promotion_periods.date_until` (string,null)
    Дата окончания действия указанной акции. Если передано значение null, акция является бессрочной. Может быть null, только если указан один период действия.
    Example: "2020-08-11T20:00:00+03:00"

  - `promotions.type` (string)
    Тип акции.
    Example: "item_discount"

  - `total_promotions_count` (integer)
    Общее количество акций.

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401