Appearance
Falls
The falls section in the markings response contains one object per time a player is estimated to have fallen to the floor sometime close to live play.
Overview
A fall is detected when a player's hips get near the ground during or close to live play. We exclude falls during stoppages due to higher data error rates in those periods.
Sample Response
json
{
"markings": {
"falls": [
{
"chance_id_ctg": "chance_389850564394d3b1753f7f56ad8ba9b7",
"duration_sec": 1.72,
"end_he_frame": 16159,
"end_wall_clock": "2025-12-23T01:15:03.782+00:00",
"fall_id_ctg": "fall_bce802d16729844e22595c66fd9aa3de",
"game_id_nba": "0022500404",
"nba_game_id": "0022500404",
"nba_player_id": 1642843,
"period": 1,
"player_id_nba": 1642843,
"start_he_frame": 16056,
"start_wall_clock": "2025-12-23T01:15:02.066+00:00"
}
]
}
}Fields
Identifiers
fall_id_ctg
Type: string
CTG-generated unique identifier for this fall event
game_id_nba
Type: string
NBA game ID
nba_game_id deprecated
Type: string
NBA game ID
Deprecated
Use game_id_nba instead. This field will be removed in a future version.
player_id_nba
Type: integer
NBA player ID of the player who fell
nba_player_id deprecated
Type: integer
NBA player ID of the player who fell
Deprecated
Use player_id_nba instead. This field will be removed in a future version.
chance_id_ctg
Type: string
CTG chance ID (if fall occurred during a chance). null otherwise
Timing
period
Type: integer
Period when the fall occurred
start_he_frame
Type: integer
Hawk-Eye frame when player's hips first got near the ground
start_wall_clock
Type: string
UTC timestamp at fall start
end_he_frame
Type: integer
Hawk-Eye frame when player's hips were no longer near the ground
end_wall_clock
Type: string
UTC timestamp at fall end
duration_sec
Type: float | Unit: seconds
How long the player's hips continuously remained near the ground during this fall