Skip to main content
Call this endpoint at the start of a game session to get the current configuration for the games your player can access. The response includes ad settings, reward configuration, version requirements, and maintenance status for each active game. Use the optional bundle_id parameter to retrieve settings for your specific game without loading the full catalog.

​
Endpoint

GET /v1/games
No authentication is required.

​
Query parameters

​
bundle_id
string
Filter the response to a single game by its Android package name or iOS bundle identifier (e.g. com.example.mygame). When omitted, all active games are returned.

​
Example requests

Without filtering — returns all active games: 
curl https://playsmart-gateway-1w8ko864.uc.gateway.dev/v1/games
With bundle_id — returns only the matching game: 
curl "https://playsmart-gateway-1w8ko864.uc.gateway.dev/v1/games?bundle_id=com.example.mygame"

​
Response

​
200 OK

The response data field is an array of game objects.
​
game_id
number
A stable numeric identifier derived from the game’s database ID. Safe to use as a local key across sessions.
​
name
string
The game’s display name.
​
bundle_id
string
The Android package name or iOS bundle identifier (e.g. com.example.mygame).
​
play_store_url
string
The Google Play Store URL for the game.
​
thumbnail_url
string | null
URL for the game’s artwork image. null if no thumbnail has been configured.
​
game_mode
string
The game’s play mode. One of: level_based, endless, hybrid.
​
coins_enabled
boolean
Whether coin rewards are active for this game. When false, do not award or display coin rewards regardless of game events.
​
ads_enabled
boolean
Whether ads are enabled for this game. Check this alongside the global ads_enabled flag from /v1/app-settings.
​
ios_store_id
string
The iOS App Store identifier for this game.
​
version
string
The current version string for this game (e.g. "1.4.2").
​
maintenance
boolean
If true, this game is unavailable. Show a maintenance UI and prevent the player from starting a session. This is true when either the game itself or the global app is in maintenance mode.
​
min_version_code
number
The minimum supported version code for this game. Prompt the player to update if their installed version code is below this value.
​
post_game_interstitial_every_n_games
number
Show a post-game interstitial ad after every N completed games for this specific game. Overrides the global setting from /v1/app-settings.
{
  "data": [
    {
      "game_id": 1738291045,
      "name": "Stack Blaster",
      "bundle_id": "com.example.stackblaster",
      "play_store_url": "https://play.google.com/store/apps/details?id=com.example.stackblaster",
      "thumbnail_url": "https://cdn.playsmart.io/thumbnails/stackblaster.png",
      "game_mode": "level_based",
      "coins_enabled": true,
      "ads_enabled": true,
      "ios_store_id": "com.example.stackblaster.ios",
      "version": "1.4.2",
      "maintenance": false,
      "min_version_code": 142,
      "post_game_interstitial_every_n_games": 3
    }
  ]
}