Retrieve available games

Retrieves data about the games managed by the Sinatra service.

Request endpoint: /games/{version}/view/detailed

Request Method: GET

Request Parameters

Parameter	Where To Place	Data Type	Description
date_from	query	String optional	The start date from which to get game data. The result contains all games that were added or updated after the specified date. If omitted, the default value is 1970-01-01. Format: YYYY-MM-DD Example: 2020-10-01
jwt-auth	header	String required	The session ID received from the login request. The session ID is valid for only 20 minutes.
operator_id	query	Integer optional	Filter the games list to return only available games for the specified casino ID. Example: 1
sub_provider	query	String optional	Filter the games list to return only available games for the specified game provider IDs. The game provider IDs must be separated by commas. Example:1,2,3
game_identifire	query	String optional	Filter for games with this text within them(id/name), for example, when searching for 888, it will return game id of 81000888, 89918881, 88800001, same goes for name
game_ids	query	String optional	comma separated game ids to fetch, not space between, example: 1111,22222,3333
game_name	query	String optional	game name to fetch, it will search anywhere in the game name for the text entered, for example search text is mega, all of: Mega 1, 1 Mega, Omega 1 are relevant
version	path	String required	The API version. Only version 1.0 is currently supported. Other version values are accepted but are treated as 1.0. Example:1.0

Example Response:

Success response:

[
  {
    "gameId": "9999999",
    "gameName": "Test Game _for EvoPlay",
    "gameType": "STANDARD",
    "gameCategory": "Slots",
    "platforms": [
      "Desktop",
      "Mobile"
    ],
    "defaultRtp": "96.21",
    "volatility": "MID",
    "supportJackpot": "No",
    "jackpotType": "RTP",
    "supportFrb": "Yes",
    "minBet": [
      {
        "value": "0.2"
      }
    ],
    "maxBet": [
      {
        "value": "100"
      }
    ],
    "maxExposure": [
      {
        "value": "2500"
      }
    ],
    "releaseDate": "2019-05-05",
    "vendorName": "EvoPlay",
    "subVendorName": "EvoPlay",
    "currencies": [
      "AED"
    ],
    "payLines": "88",
    "restrictedCountries": [
      "AL"
    ],
    "languages": [
      "Arabic"
    ],
    "supportedRegulations": [
      "MGA"
    ],
    "features": [
      "Free Spins",
      "Megaways"
    ],
    "themes": [
      "Ancient Egypt"
    ],
    "tags": [
      {
        "name": "Top Games",
        "displayOrder": 2
      },
      {
        "name": "Exclusive",
        "displayOrder": null
      }
    ],
    "defaultImg": "https://s3-eu-west-1.amazonaws.com/marketing-assets/games-dev/new/dd37270ab6f4a87a8e0beded88de0c0c4c799dfb/GamesCatalogimage/image.png"
  },
  {
    "gameId": "8021042",
    "gameName": "pending gak1",
    "gameType": "BRANDED",
    "gameCategory": "Scratch Card",
    "platforms": [
      "Desktop"
    ],
    "defaultRtp": "12",
    "volatility": "Low-Mid",
    "supportJackpot": "YES",
    "jackpotType": "Local",
    "supportFrb": "No",
    "minBet": [
      {
        "value": "11"
      }
    ],
    "maxBet": [
      {
        "value": "123"
      }
    ],
    "maxExposure": [
      {
        "value": "12"
      }
    ],
    "releaseDate": "2019-05-22",
    "subVendorName": "company3",
    "currencies": [
      "AED"
    ],
    "hitFrequency": "12",
    "restrictedCountries": [
      "AF"
    ],
    "languages": [
      "Armenian"
    ],
    "supportedRegulations": [],
    "features": [],
    "themes": [],
    "tags": [],
    "defaultImg": "https://s3-eu-west-1.amazonaws.com/marketing-assets/games-dev/new/75fcdb55ed1f1ede58aafaab4af493b1ea06df48/GamesCatalogimage/image.png"
  }
]

Error Response:

{
  "errMsg": "unauthorized"
}

Game features, themes and tags

Every game carries three arrays describing it. All three are always present — a game with none of a given type returns [].

Field	Data Type	Description
`features`	Array of String	Gameplay features, for example `Free Spins`, `Megaways`.
`themes`	Array of String	Visual or narrative themes, for example `Ancient Egypt`.
`tags`	Array of Object	Labels used to group games. Each entry has `name` and `displayOrder`.

A tags entry is an object rather than a plain name, because a tag can carry a position for that particular game:

Field	Data Type	Description
`name`	String	The tag’s name, for example `Top Games`.
`displayOrder`	Integer or null	This game’s position within that tag. `null` when no position is set.

Building a curated list such as “Top Games”: take every game whose tags contains that name, sort ascending by displayOrder, then append the games whose displayOrder is null. Note that 0 is a valid position and is not the same as null.

Things to know:

Only currently active values are returned. The set can change over time, so read it from this endpoint rather than storing it as a permanent property of a game.
These are display labels and may be renamed. Do not use them as stable keys.
Do not rely on the order of the arrays themselves. Sort by displayOrder where you need an order.

Response codes:

Code	Status	Message
200	success	Login user to site
401	unauthorized	unauthorized
403	forbidden_operation	forbidden_operation
500	internal server error	internal server error