Tournaments list for casino

This document contains information about getting list of tournaments for particular casino.

Request (GET)

/gateway/tournaments/{version}/{brand_id}

Parameters:

Name In Type Required Description
version path string true The API version to use (pagination supported in version 3.0 and above).
brand_id path string true The ID of the casino.
status query string false Comma separated list of statuses:
1=Active, currenty running tournament
2=Inactive, cancelled by operator
3=Completed, ended tournaments
0=Pending, not started
page query string false page number, starts from page 1, set to 1 if not sent
page_size query string false limits number of results per page, set to 100 if not sent

Headers

  • x-auth-token: Not requred, its better to be sent for logged in user

Postman sample:

curl --location 'http://www.my_site_backend.com/tournaments/1/1501?status=0,1' \
--header 'x-auth-token: place your token here'

Response

Name Type Description
tournament_id string The ID of the tournament.
tournament_name string The Name of the tournament defined by operator.
tournament_description string The Description of the tournament defined by operator.
status numeric Current tournament status: 0 - Pending (Not started yet), 1 - Active (Started), 2 - Inactive (stopped before start), 3 - Completed
games object List of games, participating in tournament, that exists in requested casino. It grouped by operator key, and each key contains operator
friendly name and games information (name +id)
start_date datetime Date and time of the tournament start.
end_date datetime Date and time of the tournament end.
rules object See rules structure
prizes object See prizes structure

Status 200

{
    "status": "Success",
    "data": {
        "tournaments": [
         {
                "tournament_id": "15c19ead-fc42-4be1-8b52-5b384686850d",
                "tournament_name": "automation_iutAg",
                "tournament_description": "Automation Test",
                "status": 2,
                "games": {
                    "26": {
                        "provider_name": "Betsoft",
                        "groovy_provider_id": "26",
                        "games": [
                            {
                                "game_id": "82672",
                                "game_name": "Rook's Revenge"
                            }
                         ]
                    }
                },
                "start_date": "2025-12-01 09:51:00",
                "end_date": "2025-12-02 12:00:00",
                "rules": {
                    "MinimumBetsOrRoundsRequired": [
                        {
                            "required_bets": 5,
                            "required_rounds": 10
                        }
                    ],
                    "WinToPointsConversion": [
                        {
                            "points_to_add": 10,
                            "required_win": 10
                        }
                    ]
                },
                "prizes": {
                    "SpecificPositionPrize": [
                        {
                            "position": 1,
                            "prize": 100,
                            "prize_name": "Automation"
                        }
                    ]
                }
            }
        ],
        "numberOfPages": 9,
        "tournamentsPerPage": 10,
        "tournamentsCount": 90,
        "currencyCode": "USD"
    }

Status 400 (Missing authentication header)

{
  "status" : "Error",
  "data" : {
    "errMsg" : "invalid input - invalid token"
  },
  "message" : "authentication failed",
  "userFriendlyMessage" : "Authentication failed"
}