CTG Pro Data Feed

Appearance

Jump Balls ​

The jump_balls section in the markings response contains official jump ball events from the game, including the players who won, lost, and recovered the jump ball when that information is available from the play-by-play feed.

Sample Response ​

json
{
  "markings": {
    "jump_balls": [
      {
        "event_pbp_descriptor": "startperiod",
        "event_pbp_qualifiers": null,
        "event_pbp_subtype": "tap",
        "game_clock": 720,
        "game_id_nba": "0022500404",
        "jump_ball_he_frame": 14,
        "jump_ball_id_ctg": "jump_ball_0c50d6265a2dd086b1b56ac10e944064",
        "jump_ball_lost_player_nba_id": 1629023,
        "jump_ball_recovered_player_nba_id": 1630180,
        "jump_ball_wall_clock": "2025-12-23T01:10:34.455+00:00",
        "jump_ball_won_player_nba_id": 203999,
        "pbp_event_id": 4,
        "period": 1,
        "possession_team_id_nba": 1610612743,
        "shot_clock": null
      }
    ]
  }
}

Fields ​

Identifiers ​

game_id_nba ​

Type: string

NBA game ID

jump_ball_id_ctg ​

Type: string

CTG-generated jump ball ID

pbp_event_id ​

Type: integer

Play-by-play event ID for the jump ball

possession_team_id_nba ​

Type: integer

NBA team ID of the team with possession after the jump ball. null if unavailable.

Players ​

jump_ball_won_player_nba_id ​

Type: integer

NBA player ID of the player who won the jump ball. null if unavailable.

jump_ball_lost_player_nba_id ​

Type: integer

NBA player ID of the player who lost the jump ball. null if unavailable.

jump_ball_recovered_player_nba_id ​

Type: integer

NBA player ID of the player who recovered the jump ball. null if unavailable.

Timing ​

period ​

Type: integer

Period when the jump ball occurred. null if unavailable.

game_clock ​

Type: float

Game clock, in seconds remaining, when the jump ball occurred. null if unavailable.

shot_clock ​

Type: float

Shot clock when the jump ball occurred. null if the shot clock is off or unavailable.

jump_ball_he_frame ​

Type: integer

Hawk-Eye frame of the jump ball. null if there is no corresponding Hawk-Eye frame in the Hawk-Eye event data.

jump_ball_wall_clock ​

Type: string

UTC timestamp corresponding to jump_ball_he_frame. null if there is no corresponding Hawk-Eye frame.

Play-by-Play Data ​

event_pbp_subtype ​

Type: string

The sub_type field from the official play-by-play feed. null if not provided.

event_pbp_descriptor ​

Type: string

The descriptor field from the official play-by-play feed. null if not provided.

event_pbp_qualifiers ​

Type: string

The qualifiers field from the official play-by-play feed. Currently always null; the source feeds do not provide it.