CTG Pro Data Feed

Appearance

Violations ​

The violations section in the markings response contains official violation event data from the play-by-play.

The most common violation types are:

  • kickedball: a defensive kicked ball violation.
  • defensivegoaltending: a defensive goaltending violation.
  • delayofgame: a delay of game violation.
  • lane: a lane violation.
  • doublelane: a double lane violation.
  • jumpball: a jump ball violation.

Sample Response ​

json
{
  "markings": {
    "violations": [
      {
        "defensive_team_id_nba": 1610612740,
        "event_pbp_descriptor": null,
        "event_pbp_qualifiers": null,
        "event_pbp_subtype": "defensivegoaltending",
        "game_clock": 504,
        "game_id_nba": "0022500404",
        "loc_x": null,
        "loc_y": null,
        "offensive_team_id_nba": 1610612742,
        "pbp_event_id": 596,
        "period": 4,
        "player_id_nba": 1629023,
        "region": null,
        "shot_clock": 24,
        "violation_he_frame": null,
        "violation_id_ctg": "violation_655f26d14c44425d1b8f2473577596f2",
        "violation_wall_clock": null
      }
    ]
  }
}

Fields ​

Identifiers ​

game_id_nba ​

Type: string

NBA game ID

violation_id_ctg ​

Type: string

CTG-generated violation ID

player_id_nba ​

Type: integer

NBA player ID associated with the violation. null if the violation is not attributed to a player in the event feed.

offensive_team_id_nba ​

Type: integer

NBA team ID of the offensive team at the time of the violation. null if the offensive team is unavailable.

defensive_team_id_nba ​

Type: integer

NBA team ID of the defensive team at the time of the violation. null if the defensive team cannot be inferred.

Timing ​

period ​

Type: integer

Period when the violation occurred. null if the period is unavailable.

game_clock ​

Type: float

Game clock (seconds remaining) at the violation. null if the game clock is unavailable.

shot_clock ​

Type: float

Shot clock at the violation. null if the shot clock is off or unavailable.

violation_he_frame ​

Type: integer

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

violation_wall_clock ​

Type: string

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

Play-by-Play Data ​

pbp_event_id ​

Type: integer

Play-by-play event ID for the violation

event_pbp_subtype ​

Type: string

Violation type from the official play-by-play feed. Expected values include kickedball, defensivegoaltending, delayofgame, lane, doublelane, and jumpball. null if not provided.

event_pbp_descriptor ​

Type: string

Additional violation descriptor from the official play-by-play feed. null if not provided.

event_pbp_qualifiers ​

Type: string

Qualifier information from the official play-by-play feed. null if not provided.

Court Context ​

loc_x ​

Type: float

X coordinate of the violation location in inches. null if location is unavailable.

loc_y ​

Type: float

Y coordinate of the violation location in inches. null if location is unavailable.

region ​

Type: string

Court region of the violation location. null if location is unavailable.