The specification is versioned to allow for continual improvements.
This page lists the changes in each version.
1.4.2 - 2022/07/13
Removed the explicit requirement for there to be a Showdown round in the Rounds list. This is only required if a hand goes to showdown, or a player chooses to show their cards without a showdown.
1.4.1 - 2022/03/23
Specified that the following fields are optional:
table_handle, table_skin, flags, round_obj > cards, player_obj > display
1.4.0 - 2022/02/25
Clarified that "Run_It_Twice" flag is used for any number of runs.
Added "jackpot" in <pot_obj>.
Added "cashout", "cashout_fee", "bonus" in <player_wins>.
Clarified that "amount" and "is_allin" are optional in <action_obj>.
1.2.2 - 2020/06/19
Corrected "round" to "id" in the 'id' field of <round_obj>.
1.2.1 - 2020/06/01
Corrected "players_wins" to "player_wins" in <pot_obj>.
1.2.0 - 2020/04/23
Added a root object to wrap each hand and identify the type of JSON object.
1.1.1 - 2020/02/27
hero_player_id was changed to Nullable. Null example added.
<action_obj>.cards was changed to Nullable. Null example added.
<round_object>.street options are capitalized instead of all lowercase. Example updated.
Flags options are capitalized instead of all uppercase. Example updated.
<player_obj>.player_bounty was changed to nullable. Info panel text changed from "For bounty tournaments only." to "For bounty tournaments only. Omit for other games." Null example added.
<tournament_info_obj>.flags - all non-acronym options changed to caplitalized instead of all uppercase.
<tournament_rebuy_obj> - all options changed to capitalized instead of all uppercase.
<speed_obj>.type - all options changed to capitalized instead of all uppercase.
ante_amount - corrected typo "f the game..." to "If the game...".
Rounds - "(Pre-Flop)" changed to "(Preflop)" in text to match names used in <round_obj>.street.
<bet_limit_obj>.bet_type - "No-Limit" changed to "No Limit" to match the other options.
<round_obj>.id - added text "The first round is round zero."
<round_obj>.actions - corrected typo "Maining the order..." to "Maintaining the order...".
Changed "id" to "Id" or "identifier" in text in a few places for consistency.