Activity Player List

INFO

Lists the players who received free rounds in an activity, with each player's usage.

Request Method

Item	Name	Sample
Path	Path	{Api_Address}/merchant/activity/player_list
Request Method	POST

Request Parameters

Name	Type	Required	Description
Sign Params		Y	View details
activity_id	string	Y	Activity ID
player_id	array	N	Player IDs to look up. Empty returns all players
offset	int	N	Paging offset, default 0
limit	int	N	Page size, default 20, maximum 200

Return Parameters

Name	Type	Required	Description
code	int	Y	0 means success
msg	string	Y	Error description for the code
total	int	Y	Total number of matching players
list	array	Y	Players
list[].player_id	string	Y	Player ID
list[].currency	string	Y	Currency
list[].bet_count	int	Y	Number of free rounds the player has played
list[].bet_amount	string	Y	Total bet amount of the player's free rounds
list[].reward_amount	string	Y	Total payout of the player's free rounds
list[].total_receive	int	Y	Total free rounds the player received
list[].receive_time	int	Y	Time the free rounds were received, Unix seconds
list[].expired_time	int	Y	Time the free rounds expire, Unix seconds
list[].unused_amount	int	Y	Free rounds not used yet
list[].revoked	int	Y	Free rounds that were revoked

Sample

Http Request
    Post Method
    URL : {Api_Address}/merchant/activity/player_list?mid=1697028447&sign=...&ts=1713768205
    Content-Type：application/json
    {"activity_id":"act_freebet456789","player_id":["p456"],"offset":0,"limit":20}

Http Response(success)
    {"code":0,"msg":"","total":1,"list":[{"player_id":"p456","currency":"PHP","bet_count":3,"bet_amount":"0.6","reward_amount":"1.5","total_receive":5,"receive_time":1750377600,"expired_time":1750895999,"unused_amount":2,"revoked":0}]}