Skip to content
Integration Package/RubyPlay Public API/
/
Get List of Players Parti...
Last updated

Get List of Players Participating in Campaign

This endpoint retrieves a list of players in a campaign.

API Call Sample:

curl -i -X GET \
  -u <username>:<password> \
  'https://asia.stage.rubyplay.io/api/v1/campaign/123/participant?playerId=player_12345&receivedAt=2022-01-02T11%3A21%3A30&lastRoundDate=2022-01-02T11%3A21%3A30&status=QUEUED&paging.pageNumber=5&paging.pageSize=10&paging.sortBy=id&paging.order=ASCENDING'
Response
application/json
{
  "content": [
    {
      "id": 7,
      "playerId": "player123",
      "receivedAt": "2022-02-22T22:22:22Z",
      "totalBet": 777,
      "totalWin": 77,
      "roundsPlayed": 7,
      "lastRoundDate": "2022-02-22T22:22:22Z",
      "status": "QUEUED"
    }
  ],
  "total": 0,
  "_metadata": {
    "pagingInfo": {
      "pageNumber": 5,
      "pageSize": 10,
      "sortBy": "id",
      "order": "ASCENDING"
    },
    "totalNumberOfElements": 0
  }
}

Query Parameters:

playerIdstring

Player identifier in the Operator side

Example: "player_12345"
receivedAtstring(date)

Date and time of receiving free rounds

lastRoundDatestring(date)

Date and time of the last played free round within the campaign

statusstring

  • QUEUED - A bonus is awarded to a player who has not used any of the free rounds yet.

  • IN_USE - A bonus is awarded to a player who has accepted the campaign. This status also applies to players who have started but haven't completed the free rounds yet. Free rounds for those players remain available even after the expiry date of the campaign.

  • COMPLETED - The player consumed all available free rounds, and any winnings have been awarded (issued to the Operator).

  • EXPIRED - The expiry date for free rounds has been reached, the promotion has been removed from player accounts, and any players who have not participated yet are not able to complete the promotion.

  • OPT_OUT - Player has declined the promotion pop up

Example: "QUEUED"
pagingobject(PagingInfo)

Response Schema:

contentArray of objects(ParticipantDto)
totalinteger(int64)
_metadataobject(PagingMetadata)
Previous page
Next page