Get list of item promotions

Get list of item promotionsServer-sideAdmin

get/v2/project/{project_id}/admin/promotion/item

Get the list of item promotions of a project.

Promotions provide a discount (%) on items. The discount will be applied to all prices of the specified items.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 59080

Project ID.

query Parameters

limit	integer Limit for the number of elements on the page.
offset	integer Number of the element from which the list is generated (the count starts from 0).

Responses

200

List of item promotions was successfully received.

401

Basic authentication not passed or wrong. Make sure you used basic authentication or correct credentials.

Request samples

Response samples

application/json

{"promotions": [{"id": 1,
"date_start": "2020-04-15T18:16:00+05:00",
"date_end": "2020-04-25T18:16:00+05:00",
"is_enabled": true,
"discount": {"percent": "20.00"
},
"items": [{"sku": "com.xsolla.elven_sword_1"
}
],
"name": {"en-US": "Promotion",
"ru-RU": "Акция"
},
"limits": {"per_user": null,
"per_item": null,
"recurrent_schedule": null
}
},
{"id": 2,
"date_start": "2020-04-15T18:16:00+05:00",
"date_end": "2020-04-25T18:16:00+05:00",
"is_enabled": true,
"discount": {"percent": "10.00"
},
"items": [{"sku": "com.xsolla.elven_helmet_1"
},
{"sku": "com.xsolla.elven_armor_1"
}
],
"name": {"en-US": "Promotion",
"ru-RU": "Акция"
},
"limits": {"per_user": {"total": 10
},
"per_item": null,
"recurrent_schedule": {"per_user": {"interval_type": "daily",
"day_of_week": null,
"day_of_month": null,
"time": "11:00:00+08:00",
"reset_next_date": 1677553200,
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00"
}
}
},
"excluded_promotions": [1,
3
]
},
{"id": 3,
"date_start": "2020-04-15T18:16:00+05:00",
"date_end": "2020-04-25T18:16:00+05:00",
"is_enabled": true,
"discount": {"percent": "10.00"
},
"items": [{"sku": "com.xsolla.elven_helmet_2"
},
{"sku": "com.xsolla.elven_armor_2"
}
],
"name": {"en-US": "Promotion",
"ru-RU": "Акция"
},
"limits": {"per_user": {"total": 10
},
"per_item": null,
"recurrent_schedule": {"per_user": {"interval_type": "daily",
"day_of_week": null,
"day_of_month": null,
"time": "11:00:00+08:00",
"reset_next_date": 1677553200,
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00"
}
}
},
"price_conditions": [{"operator": "gt",
"value": "10.0000"
},
{"operator": "lt",
"value": "20.0000"
}
]
},
{"id": 4,
"date_start": "2020-04-15T18:16:00+05:00",
"date_end": "2020-04-25T18:16:00+05:00",
"is_enabled": true,
"discount": {"percent": "10.00"
},
"items": null,
"name": {"en-US": "Promotion",
"ru-RU": "Акция"
},
"limits": {"per_user": {"total": 10
},
"per_item": null,
"recurrent_schedule": {"per_user": {"interval_type": "daily",
"day_of_week": null,
"day_of_month": null,
"time": "11:00:00+08:00",
"reset_next_date": 1677553200,
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00"
}
}
},
"price_conditions": [{"operator": "lt",
"value": "20.0000"
}
]
}
],
"total_promotions_count": 4,
"active_promotions_count": 4,
"inactive_promotions_count": 0
}