Skip to main content
GET
Get game state

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:
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.