Skip to main content
GET
/
api
/
tables
/
{tableId}
/
state
Get game state
curl --request GET \
  --url https://hedgeem-v5.qeetoto.com/api/tables/{tableId}/state \
  --header 'Authorization: Bearer <token>'
{
  "tableId": 1,
  "gameId": "game-001",
  "gameState": "STATUS_HOLE",
  "bettingStage": 0,
  "numberOfHands": 4,
  "numberOfSeats": 6,
  "jackpotValue": 1250,
  "hands": [
    "AcKd",
    "QsJs",
    "8h7c",
    "5d2c"
  ],
  "flopCard1": "Ah",
  "flopCard2": "3s",
  "flopCard3": "9d",
  "turnCard": null,
  "riverCard": null,
  "seats": [
    {
      "seatId": 1,
      "playerId": "abc123",
      "playerName": "Simon",
      "seatBalance": 500,
      "avatarImageUrl": "/avatars/user_square.jpg"
    }
  ],
  "bets": [
    {
      "playerId": "abc123",
      "bettingStage": 0,
      "seatIndex": 0,
      "handIndex": 0,
      "betAmount": 50,
      "recordedOdds": 1.6
    }
  ],
  "handOdds": [
    {
      "handIndex": 0,
      "bettingStage": 0,
      "handStatus": "IN_PLAY_FAVOURITE",
      "winPercentage": 62.4,
      "drawPercentage": 2.1,
      "odds": 1.6
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Supabase Auth JWT. Obtain via Supabase Auth sign-in.

Path Parameters

​
tableId
integer
required

Unique numeric table identifier

Required range: x >= 1
Example:

1

Response

Current game state

Full game state for a Texas Hedge'Em table at a point in time. This is the primary object consumed by the game client (gameClient/).

​
tableId
integer
Example:

1

​
gameId
string
Example:

"game-001"

​
gameState
enum<string>

The lifecycle state of a Texas Hedge'Em game. States progress linearly: SETUP → START → HOLE → FLOP → TURN → RIVER.

Available options:
UNCHANGED,
INVALID_CARD,
CARD_ALREADY_DEALT,
STATUS_SETUP,
STATUS_START,
STATUS_MANUAL_DEALING_HOLE,
STATUS_HOLE,
STATUS_FLOP_CARD1,
STATUS_FLOP_CARD2,
STATUS_FLOP_CARD3,
STATUS_FLOP,
STATUS_TURN,
STATUS_RIVER
Example:

"STATUS_HOLE"

​
bettingStage
enum<integer>

The current betting stage.

  • -1 NON_BETTING — no bets accepted (river, setup)
  • 0 HOLE — betting on hole cards
  • 1 FLOP — betting on flop cards
  • 2 TURN — betting on turn card
Available options:
-1,
0,
1,
2
Example:

0

​
numberOfHands
integer

Number of simultaneous hands in play (typically 4)

Example:

4

​
numberOfSeats
integer

Total seat capacity at this table

Example:

6

​
jackpotValue
number

Current jackpot value in chips

Example:

1250

​
hands
(string | null)[]

The four hole card pairs as card strings (e.g. "AcKd"). Null before STATUS_HOLE. See Card Notation.

Example:
["AcKd", "QsJs", "8h7c", "5d2c"]
​
flopCard1
string | null

First community card. Null before STATUS_FLOP.

Example:

"Ah"

​
flopCard2
string | null
Example:

"3s"

​
flopCard3
string | null
Example:

"9d"

​
turnCard
string | null

Turn card. Null before STATUS_TURN.

Example:

null

​
riverCard
string | null

River card. Null before STATUS_RIVER.

Example:

null

​
seats
object[]
​
bets
object[]

All bets placed in the current game

​
handOdds
object[]

Odds panel data for each hand at each betting stage. The game client uses this to render betting panels.