Game List Endpoint

This document describes the /game_list endpoint of the Feed API, which provides a list of available games and their metadata.

---

Endpoint

POST {KLAS_GAMING_BASE_URL}/game_list

---

Authentication

All requests to this endpoint must include Authentication header as described in Feed API Authentication.

Example header:

Authorization: <Base64-encoded access_id:secret_id>

---

Request

• Method: POST
• Headers:
  • Authorization: <Base64-encoded access_id:secret_id>
  • Content-Type: application/json

No request body is required.

---

Response

Success Example

{
  "type": "success",
  "status": 200,
  "data": {
    "casino": {
      "slot": {
        "games": [
          {
            "id": "e2e53db1-9f45-4a3a-bc8c-90211f6a8f3e",
            "name": "Warp War",
            "game_code": "CF-Z7X9",
            "description": "Flip a coin and predict the outcome.",
            "rtp": 96,
            "volatility": "Low",
            "min_bet": 0.1,
            "max_bet": 1000000,
            "currency": "USD",
            "max_payout": 50000000,
            "features": {
              "feature1": "50-50-chance"
            },
            "url": "https://flip.klasbase.com",
            "play_count": 1102,
            "status": 1,
            "created_at": "2025-05-14T12:00:00Z",
            "updated_at": "2025-06-10T01:28:16.087Z"
          }
        ]
      },
      "live_casino": {
        "games": []
      },
        "live_video_slot": {
            "games": []
        },
    },
  }
}

---

Response Fields

Field	Type	Description
type	string	Response type (e.g., "success")
status	number	HTTP status code (e.g., 200)
data.games	array	List of game objects
id	string	Unique game identifier
name	string	Game name
game_code	string	Game code
description	string	Game description
rtp	number	Return to player percentage
volatility	string	Volatility level (e.g., "High")
min_bet	number	Minimum bet amount
max_bet	number	Maximum bet amount
currency	string	Supported currency (ISO-4217, e.g., USD)
max_payout	number	Maximum payout
features	object	Game features (key-value pairs)
url	string	Game launch URL
play_count	number	Number of times the game has been played
status	number	Game status (e.g., 1 = active)
created_at	string	Creation timestamp (ISO 8601)
updated_at	string	Last update timestamp (ISO 8601)

---

Error Handling

• If authentication fails or credentials are missing, the API will return a 401 Unauthorized error.
• For other errors, standard HTTP error codes and messages are returned.

---

Example Request

curl -X POST https://<feed-api-host>/game_list \
  -H "Authorization: <Base64-encoded access_id:secret_id>" \
  -H "Content-Type: application/json"

---

Notes

• The list of games and their metadata may change over time; always fetch the latest data as needed.