Fetch Games

Retrieve the list of available games and their configuration details from Phoenix Games.

`GET /api/v0.2/fetch-games`

Retrieve all games and their instances available for the operator.

Authentication

All requests require the following headers:

Header	Type	Required	Description
`X-Operator-Id`	string	Yes	Unique identifier for the operator
`X-Signature`	string	Yes	Base64 URL-safe encoded RSA signature of the request body

Signature Verification

For GET requests:

Sign the operator ID (from X-Operator-Id header)
The value is signed using RSA-SHA256 with the operator's private key
The signature is Base64 URL-safe encoded (no padding)
The server verifies the signature using the operator's registered public key

Request: No body required

Response

{
  "games": [
    {
      "id": "game_123",
      "name": "Crash Game",
      "status": "ACTIVE",
      "thumbnail_url": "https://example.com/thumbnail.png",
      "provider_name": "Phoenix Games",
      "rtp": 96.5,
      "genre": "Crash",
      "instances": [
        {
          "id": "instance_456",
          "name": "Crash Classic",
          "active": true,
          "bet_config": {
            "min_wager": 1.00,
            "max_wager": 1000.00,
            "default_wager": 10.00,
            "currency": "USD",
            "max_win": 10000.00
          }
        }
      ]
    }
  ]
}

Error Response

{
  "error": "string"
}

Response Fields

GameInfo Object

Field	Type	Description
`id`	string	Unique game identifier
`name`	string	Display name of the game
`status`	string	Game status (ACTIVE, INACTIVE, MAINTENANCE, COMING_SOON)
`thumbnail_url`	string?	URL to game thumbnail image
`provider_name`	string	Name of the game provider
`rtp`	number?	Return to player percentage
`genre`	string	Game genre
`instances`	GameInstance[]	Array of game instances for this operator

GameInstance Object

Field	Type	Description
`id`	string	Unique instance identifier
`name`	string	Display name of the instance
`active`	boolean	Whether the instance is currently active
`bet_config`	BetConfig	Betting configuration for this instance

BetConfig Object

Field	Type	Description
`min_wager`	number	Minimum bet amount
`max_wager`	number	Maximum bet amount
`default_wager`	number	Default bet amount
`currency`	string	Currency code (e.g., "USD")
`max_win`	number	Maximum win amount

Status Codes

200 OK - Request processed successfully
400 Bad Request - Invalid request
401 Unauthorized - Authentication failed

Game Genres

Available genres include:

AndarBahar, Baccarat, Bingo, Blackjack, BoardGame, CoinDozer
Craps, Crash, Dice, DragonTiger, HeadsOrTails, HiLo
InstantWin, Keno, LiveBlackjack, LiveRoulette, Ladder, Lobby
MatchAndWin, Mine, Plinko, Poker, Roulette, ScratchCards
SetteEMezzo, Shooting, Show, SicBo, Slots, VideoPoker, Wheel, Other

Error Response:

{
  "error": "Authentication failed"
}

Use Cases

Display available games to players
Configure betting limits
Check game availability before embedding
Update game listings dynamically

On this page