Game History

This guide explains how to view and search hand histories and player session records in the admin panel.

Game History

Navigate to Game Management > Game History to view all hands played across the platform.

Required: the gameHistory feature toggle must be enabled in Settings > Features for the menu item to appear, and your group needs the tables:view_history permission.

What Is Shown

Each row in the game list represents one completed hand:

Column	Description
Hand #	Sequential hand number within the table
Table	Table where the hand was played
Format	Rule format of the hand
Date/Time	When the hand started
Players	Number of players dealt into the hand
Pot	Total chips in the final pot
Rake	Amount collected as rake

Filtering

Use the filter bar to narrow results:

Filter	Type	Description
Table	Dropdown	Filter to a specific table (loads all tables, up to 200)
User	Search	Type a username to search, then select from the dropdown. Clears with the X button.
From Date	Date	Show hands started on or after this date
To Date	Date	Show hands started on or before this date (inclusive of the full day)

Click Clear Filters to reset all filters and return to page 1.

Results are paginated at 20 hands per page.

Viewing a Hand in Detail

Click the View button (or the row on mobile) to open the Game Detail modal.

Game Detail Modal

The detail view shows:

Summary panel:

• Table name, hand number
• Format
• Start timestamp
• Total pot size
• Rake collected

Deck Procedure: The recorded deck procedure audits for the hand, with Repair and Void controls when the hand allows them. These controls write immutable compensating audit events.

Position info:

• Dealer seat number
• Small blind and big blind seats, or the forced posts for Stud (Bring-in / Completion) and for antes and button blinds
• Button freeze state, including the pre-freeze button

Community Cards: The flop, turn, and river cards rendered as playing card graphics. If the hand ended before the flop, a "No community cards" message is shown; Stud hands show "No board cards for Stud".

Players table:

Column	Description
Seat	Seat number, with a dealer button marker (D)
Player	Username, with folded/all-in status labels
Chips Before	Stack at the start of the hand
Chips After	Stack at the end of the hand
Hole Cards	Cards dealt (shown face-up for all players); mucked hands show face-down card placeholders
Final Hand	Hand rank at showdown (e.g., "Full House")
P/L	Net profit or loss for this hand (green for win, red for loss)

Winners panel: Each winner is shown with their username, winning hand description, and the amount won. Hi-lo hands also show a Hi-Lo Summary with high and low winners, whether a low qualified, scoops, ties, and odd chips.

Actions Timeline: All betting actions grouped by street (Pre-flop, Flop, Turn, River, Showdown, or 3rd through 7th Street for Stud). Each entry shows the player, action type, and bet/raise amount where applicable.

Action types shown: Fold, Check, Call, Bet, Raise, All-in, Small Blind, Big Blind, Ante, Button Blind, Bring-in, Completion, Post Blind.

Per-Game Audit Trail

For detailed event-level auditing of a specific hand, use the API endpoint directly:

GET /api/v1/admin/games/{gameId}/audit

This returns every server-side event recorded for that hand (state transitions, actions, errors), useful for investigating disputes or debugging game logic.

Session History

Navigate to User Management > Session History to view player table sessions. This requires the admin-sessions:view permission.

A session is one continuous period that a player spent seated at a specific table — from buy-in to cash-out.

What Is Shown

Column	Description
User	Player username
Table	Table name
Start Time	When the player joined the table
End Time	When the player left (or "Active" badge if still seated)
Duration	Total time at the table (formatted as Xh Ym)
Buy-in	Chips the player brought to the table
Cash-out	Chips the player left with
P/L	Net result (green for profit, red for loss)
Actions	Open the session details

Results are paginated at 20 sessions per page.

Filtering

Filter	Type	Description
Table	Dropdown	Filter to a specific table
User	Search	Type and select a username
From Date	Date	Sessions that started on or after this date
To Date	Date	Sessions that started on or before this date
Active Only	Checkbox	Show only sessions still in progress

Viewing a Session in Detail

Click View to open the Session Details modal.

Session Details Modal

User Information:

• Username
• User ID

Table Information:

• Table name
• Table ID

Session Timing:

• Start time
• End time (or "Active" if still in progress)
• Total duration

Financial Summary:

• Buy-in amount
• Cash-out amount
• Profit/Loss (color-coded)
• Total hands played during this session

Hands Played: A table listing every hand played during the session:

Column	Description
Hand #	Sequential hand number
Time	When the hand started
Pot	Total pot for that hand
Rake	Rake collected
Result	Player’s net result for that hand
Actions	Link to open the full game detail in Game History

Audit Trails

Admin Audit Log

Administrative actions are captured in the system audit log. Review them under Settings > Logs, in the Admin Actions tab. See Logs.

Game-Level Audit

Each hand has a full server-side event log accessible via the history API (see Per-Game Audit Trail above). This is the authoritative record of every state transition and player action.

AML and Compliance Audit

Transaction-level auditing for AML purposes is handled separately under Compliance > AML Reviews. See Compliance for details.

Related

• Compliance — fraud alerts and AML reviews
• Settings — Features Tab — enable gameHistory feature toggle