1. Game
[Game] FairPlay API
  • Getting Started
    • Introduction
    • Session and Token
    • Request and Response
    • Real-time Events (SSE)
    • Lotto Rules — หวยเฮงเฮง
    • Provably Fair
  • Player
    • Demo
      • Demo Login
    • Player Bet History
      GET
  • Common
    • Game
      • By Game Code
        • Provably Fair
          • Set Client Seed
          • Verify Result
          • Get Revealed Server Seed
        • Check Session
        • Get Balance
        • Get Provably-Fair State
      • Lobby Game List
        GET
  • Wallet
    • Wallet Status
      GET
  • Game
    • Lotto (หวยเฮงเฮง)
      • Lotto Rules
      • Rooms
        • By Room
          • Join Round
          • Place Multi-player Bet
          • Get Round Result
          • Room Event Stream
      • Tickets
        • Create Ticket
        • Inquiry My Tickets
        • Get Ticket
      • Round
        • Get My Bets
        • Get My Result
        • Get Round Provably Fair
      • Results
        • Inquiry Results
      • Get Rooms
      • Get Current Round
      • Get Pay Table
  • Appendix
    • Game List
    • Error Codes
    • Rate Limits
  • Language List
    GET
  • Ping
    GET
  • Schemas
    • DemoLoginRequest
    • DemoLoginResponse
    • DemoProfileResponse
    • ProfileResponse
    • GetHistoryResponse
    • BetRecord
    • GameInfo
    • Room
    • GetGameResponse
    • BetRequest
    • Bet
    • BetResponse
    • BetResult
    • GetProvablyFairResponse
    • SetClientSeedRequest
    • SetClientSeedResponse
    • RotateServerSeedResponse
    • VerifyResultRequest
    • VerifyResultResponse
    • GetServerSeedResponse
    • GetStatusResponse
    • JoinRoundResponse
    • PlaceMultiPlayerBetRequest
    • PlaceBetResponse
    • RoundResultResponse
    • SuccessResponse
    • ErrorResponse
  1. Game

Lobby Game List

GET
/gapi/v1/c/g/
Returns the active games for the player's currency, with labels in the player's language. FE calls it to render the game lobby.
Auth: Player session — Authorization: Bearer {token}
Rate limit: 300 requests per 60 s per IP (GAME_GET_GAMES)
Rules
Also answers at /gapi/v1/c/g (without the trailing slash).
currency defaults to the session currency; an override is used as sent (not upper-cased), so send it upper-case.
The order is not guaranteed and can change between calls; sort on the client (e.g. by id).
Only active games are listed: status is always 1 and isDemo is always true.
A listed game can still answer 400 99921 from its room list when none of its rooms serves the currency.
Per-game maintenance is not reflected in the list; only system-wide maintenance blocks this call.
Never answers an application error: when the game list cannot be read the answer is 200 with data [].
The list is refreshed at most every 5 minutes; name, title and description follow Accept-Language, then the game-launch language, then English.
Flow
1.
Validates the token and checks system maintenance.
2.
Takes the currency from the query, else from the session.
3.
Builds (or reuses, for up to 5 minutes) the list of active games for that currency and demo/real mode.
4.
Translates name, title and description to the request language.
5.
Returns the list; returns [] when the game list cannot be read.

Request

Query Params

Header Params

Responses

🟢200OK
application/json
Bodyapplication/json

🟠401Unauthorized
🟠429Too Many Requests
🔴500Internal Server Error
🔴503Service Unavailable
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://dev-api.ambfairgame.com/gapi/v1/gapi/v1/c/g/?currency=THB' \
--header 'Authorization: Bearer 3f9a1c7e5b2d4f6081a3c5e7f9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7' \
--header 'Accept-Language: th'
Response Response Example
200 - Two games
Lobby for THB.
{
    "code": "0",
    "description": "Success.",
    "traceID": "0f8e2c1a-6b3d-4e5f-9a7b-1c2d3e4f5a6b",
    "data": [
        {
            "id": 1,
            "code": "THAI-HILO",
            "name": "Thai Hilo",
            "title": "ไฮโลไทย",
            "description": "Guess high or low.",
            "type": "DICE",
            "status": 1,
            "isDemo": true
        },
        {
            "id": 2,
            "code": "LOTTO",
            "name": "Lotto",
            "title": "หวยเฮงเฮง",
            "description": "Pick numbers and win.",
            "type": "NUMBER",
            "status": 1,
            "isDemo": true
        }
    ]
}
Modified at 2026-09-30 13:51:20
Previous
Get Provably-Fair State
Next
Wallet Status
Built with