Skip to main content
Fetch this endpoint once on app launch to configure your game client before the player sees any UI. The settings control whether the app is in maintenance mode, which app versions are supported, how frequently ads are shown, and the rules governing withdrawal requests.

​
Endpoint

GET /v1/app-settings
No authentication is required.

​
Example request

curl https://playsmart-gateway-1w8ko864.uc.gateway.dev/v1/app-settings

​
Response

​
200 OK

The response data field is an array containing a single settings object.
​
version
string
The current app version string (e.g. "2.1.0").
​
maintenance
boolean
If true, the app is in maintenance mode. Show a maintenance screen and prevent the player from proceeding.
​
ios_store_id
string
The iOS App Store identifier for the application.
​
min_version_code
number
The minimum required version code. Force-update any client running a version code below this value before allowing access.
​
ads_enabled
boolean
Whether ads are globally enabled across the platform. When false, suppress all ad requests regardless of per-game settings.
​
post_game_interstitial_every_n_games
number
Show a post-game interstitial ad after every N games completed. A value of 1 means after every game. Per-game overrides take precedence when available.
​
minimum_withdrawal_amount
number
The minimum USD amount a player must request in a single withdrawal. Reject withdrawal attempts below this threshold on the client before submitting.
​
withdraw_cooldown_hours
number
The number of hours a player must wait between consecutive withdrawal requests. Enforce this on the client to avoid unnecessary 422 errors.
​
conversion_interval_minutes
number
How often (in minutes) the server-side coin-to-USD conversion job runs. Use this to set a polling interval if you display a live balance.
​
initial_conversion_time
string
The time of day when the first daily conversion runs (e.g. "12:00"). Use together with conversion_interval_minutes to predict upcoming conversion windows.
​
on_app_resume_get_user_after_x_seconds
number
Number of seconds to wait after the app resumes from the background before refreshing the player’s profile data. Use this to throttle unnecessary refetch calls.
​
on_conversion_get_user_after_x_seconds
number
Number of seconds to wait after a coin conversion event before refreshing the player’s profile. Allows the server time to settle the new balance before your client reads it.
{
  "data": [
    {
      "version": "2.1.0",
      "maintenance": false,
      "ios_store_id": "com.playsmart.app",
      "min_version_code": 210,
      "ads_enabled": true,
      "post_game_interstitial_every_n_games": 3,
      "minimum_withdrawal_amount": 5,
      "withdraw_cooldown_hours": 24,
      "conversion_interval_minutes": 120,
      "initial_conversion_time": "12:00",
      "on_app_resume_get_user_after_x_seconds": 10,
      "on_conversion_get_user_after_x_seconds": 0
    }
  ]
}