GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NBA, WNBA, G League APIs

Technical Foul Update

Release Date

Feeds

Benefit

12/19/2023

Game Boxscore

Added support for non-unsportsmanlike technical fouls to accurately reflect the number of technicals that lead to a player ejection.

    This update includes:

    * A new event\_type of `technicalfoulnonunsportsmanlike` in the Play-by-Play endpoint.
    * A `tech_fouls_non_unsportsmanlike` player attribute at the game and season level. This attribute will account for non-unsportsmanlike technical fouls and will be handled in the same manner as the existing `tech_fouls` attribute within the API.
{
  "id": "703e6960-62af-4495-92f2-d68a4effcc2f",
  "event_type": "technicalfoulnonunsportsmanlike",
  "sequence": 1702084422300,
  "number": 13,
  "clock_fraction": 0,
  "clock": "11:25",
  "clock_decimal": "11:25",
  "updated": "2023-12-09T05:02:56Z",
  "wall_clock": "2023-12-09T01:13:42Z",
  "description": "Cavaliers technical foul (Defensive three second)",
  "qualifiers": [
    {
      "qualifier": "1freethrow"
    }
  ],
  "attribution": {
    "name": "Cavaliers",
    "market": "Cleveland",
    "reference": "1610612739",
    "id": "583ec773-fb46-11e1-82cb-f4ce4684ea4c",
    "team_basket": "left"
  },
  "possession": {
    "name": "Heat",
    "market": "Miami",
    "reference": "1610612748",
    "id": "583ecea6-fb46-11e1-82cb-f4ce4684ea4c"
  },
  "on_court": {
    "home": {
      "name": "Heat",
      "market": "Miami",
      "reference": "1610612748",
      "id": "583ecea6-fb46-11e1-82cb-f4ce4684ea4c",
      "players": [
        {
          "full_name": "Caleb Martin",
          "jersey_number": "16",
          "reference": "1628997",
          "id": "566685c7-ff63-439a-8888-5278904835fa"
        },
        {
          "full_name": "Orlando Robinson",
          "jersey_number": "25",
          "reference": "1631115",
          "id": "cbceca06-325c-492c-a995-873ec07bc64e"
        },
        {
          "full_name": "Kyle Lowry",
          "jersey_number": "7",
          "reference": "200768",
          "id": "8c090758-6baa-468d-82fd-d47e17d5091b"
        },
        {
          "full_name": "Jimmy Butler",
          "jersey_number": "22",
          "reference": "202710",
          "id": "0e163d44-67a7-4107-9421-5333600166bb"
        },
        {
          "full_name": "Duncan Robinson",
          "jersey_number": "55",
          "reference": "1629130",
          "id": "18d35316-9f40-408c-abcc-ab49e06ef8e8"
        }
      ]
    },
    "away": {
      "name": "Cavaliers",
      "market": "Cleveland",
      "reference": "1610612739",
      "id": "583ec773-fb46-11e1-82cb-f4ce4684ea4c",
      "players": [
        {
          "full_name": "Max Strus",
          "jersey_number": "1",
          "reference": "1629622",
          "id": "f6aff1dc-15b9-4c89-a2fb-746f4cf78890"
        },
        {
          "full_name": "Darius Garland",
          "jersey_number": "10",
          "reference": "1629636",
          "id": "b79b88e1-35ef-4947-8a61-f6ec631a1e15"
        },
        {
          "full_name": "Dean Wade",
          "jersey_number": "32",
          "reference": "1629731",
          "id": "bbeecf0c-62c6-4211-991d-2afaf2403623"
        },
        {
          "full_name": "Donovan Mitchell",
          "jersey_number": "45",
          "reference": "1628378",
          "id": "b6dde96e-3748-4cbe-86d2-798d5dffb3c0"
        },
        {
          "full_name": "Jarrett Allen",
          "jersey_number": "31",
          "reference": "1628386",
          "id": "a3fff5c7-19b6-4dac-bd75-11b944bea505"
        }
      ]
    }
  },
  "statistics": [
    {
      "type": "technicalfoulnonunsportsmanlike",
      "team": {
        "name": "Cavaliers",
        "market": "Cleveland",
        "reference": "1610612739",
        "id": "583ec773-fb46-11e1-82cb-f4ce4684ea4c"
      }
    }
  ]
}
{
  "full_name": "Josh Richardson",
  "first_name": "Josh",
  "last_name": "Richardson",
  "position": "G",
  "primary_position": "SG",
  "jersey_number": "0",
  "reference": "1626196",
  "id": "ef11cca9-6605-44e8-943e-193c7b821465",
  "played": true,
  "active": true,
  "on_court": false,
  "statistics": {
    "minutes": "30:44",
    "field_goals_made": 6,
    "field_goals_att": 11,
    "field_goals_pct": 54.5,
    "effective_fg_pct": 77.3,
    "three_points_made": 5,
    "three_points_att": 7,
    "three_points_pct": 71.4,
    "two_points_made": 1,
    "two_points_att": 4,
    "two_points_pct": 25.0,
    "blocked_att": 0,
    "free_throws_made": 0,
    "free_throws_att": 0,
    "free_throws_pct": 0.0,
    "offensive_rebounds": 0,
    "defensive_rebounds": 1,
    "rebounds": 1,
    "assists": 2,
    "turnovers": 1,
    "steals": 1,
    "blocks": 0,
    "assists_turnover_ratio": 2.0,
    "fouls_drawn": 2,
    "personal_fouls": 3,
    "offensive_fouls": 1,
    "tech_fouls": 2,
    "tech_fouls_non_unsportsmanlike": 1,
    "flagrant_fouls": 0,
    "pls_min": 7,
    "points": 17,
    "second_chance_pts": 0,
    "points_off_turnovers": 0,
    "points_in_paint": 2,
    "points_in_paint_att": 3,
    "points_in_paint_made": 1,
    "points_in_paint_pct": 33.3,
    "field_goals_at_rim_att": 2,
    "field_goals_at_rim_made": 1,
    "field_goals_at_rim_pct": 50.0,
    "field_goals_at_midrange_att": 1,
    "field_goals_at_midrange_made": 0,
    "field_goals_at_midrange_pct": 0.0,
    "double_double": false,
    "triple_double": false,
    "efficiency": 11,
    "efficiency_game_score": 12.2,
    "true_shooting_att": 11.0,
    "true_shooting_pct": 77.3,
    "defensive_rating": 117.282856319918,
    "coach_ejections": 0,
    "offensive_rating": 131.986169276803,
    "fast_break_pts": 2,
    "fast_break_att": 1,
    "fast_break_made": 1,
    "fast_break_pct": 100.0,
    "second_chance_att": 1,
    "second_chance_made": 0,
    "second_chance_pct": 0.0,
    "minus": 65,
    "plus": 72,
    "defensive_rebounds_pct": 3.71858377736839,
    "offensive_rebounds_pct": 0.0,
    "rebounds_pct": 1.77477862101673,
    "steals_pct": 1.57060054957233,
    "turnovers_pct": 8.33333333333333,
    "coach_tech_fouls": 0,
    "periods": [
      {
        "id": "f0f60103-052f-417a-8cf9-8ea9741b2a6f",
        "sequence": 1,
        "number": 1,
        "type": "REG",
        "minutes": "5:39",
        "field_goals_made": 3,
        "field_goals_att": 3,
        "field_goals_pct": 100.0,
        "effective_fg_pct": 133.3,
        "three_points_made": 2,
        "three_points_att": 2,
        "three_points_pct": 100.0,
        "two_points_made": 1,
        "two_points_att": 1,
        "two_points_pct": 100.0,
        "blocked_att": 0,
        "free_throws_made": 0,
        "free_throws_att": 0,
        "free_throws_pct": 0.0,
        "offensive_rebounds": 0,
        "defensive_rebounds": 0,
        "rebounds": 0,
        "assists": 0,
        "turnovers": 1,
        "steals": 1,
        "blocks": 0,
        "assists_turnover_ratio": 0.0,
        "fouls_drawn": 0,
        "personal_fouls": 1,
        "flagrant_fouls": 0,
        "tech_fouls": 0,
        "tech_fouls_non_unsportsmanlike": 0,
        "offensive_fouls": 1,
        "pls_min": 11,
        "points": 8,
        "second_chance_pts": 0,
        "points_off_turnovers": 0,
        "points_in_paint": 2,
        "points_in_paint_att": 1,
        "points_in_paint_made": 1,
        "points_in_paint_pct": 100.0,
        "field_goals_at_rim_att": 1,
        "field_goals_at_rim_made": 1,
        "field_goals_at_rim_pct": 100.0,
        "field_goals_at_midrange_att": 0,
        "field_goals_at_midrange_made": 0,
        "field_goals_at_midrange_pct": 0.0,
        "efficiency": 7,
        "efficiency_game_score": 6.7,
        "true_shooting_att": 3.0,
        "true_shooting_pct": 133.3,
        "defensive_rating": 61.9029068963205,
        "offensive_rating": -2225.06630263416,
        "fast_break_pts": 2,
        "fast_break_att": 1,
        "fast_break_made": 1,
        "fast_break_pct": 100.0,
        "second_chance_att": 0,
        "second_chance_made": 0,
        "second_chance_pct": 0.0,
        "minus": 5,
        "plus": 16,
        "defensive_rebounds_pct": 0.0,
        "offensive_rebounds_pct": 0.0,
        "rebounds_pct": 0.0,
        "steals_pct": 7.77413545135335,
        "turnovers_pct": 25.0
      },
      {
        "id": "ff615485-f1ef-4890-b324-01273705ba72",
        "sequence": 2,
        "number": 2,
        "type": "REG",
        "minutes": "9:56",
        "field_goals_made": 3,
        "field_goals_att": 5,
        "field_goals_pct": 60.0,
        "effective_fg_pct": 90.0,
        "three_points_made": 3,
        "three_points_att": 4,
        "three_points_pct": 75.0,
        "two_points_made": 0,
        "two_points_att": 1,
        "two_points_pct": 0.0,
        "blocked_att": 0,
        "free_throws_made": 0,
        "free_throws_att": 0,
        "free_throws_pct": 0.0,
        "offensive_rebounds": 0,
        "defensive_rebounds": 0,
        "rebounds": 0,
        "assists": 1,
        "turnovers": 0,
        "steals": 0,
        "blocks": 0,
        "assists_turnover_ratio": 0.0,
        "fouls_drawn": 1,
        "personal_fouls": 1,
        "flagrant_fouls": 0,
        "tech_fouls": 0,
        "tech_fouls_non_unsportsmanlike": 0,
        "offensive_fouls": 0,
        "pls_min": -8,
        "points": 9,
        "second_chance_pts": 0,
        "points_off_turnovers": 0,
        "points_in_paint": 0,
        "points_in_paint_att": 1,
        "points_in_paint_made": 0,
        "points_in_paint_pct": 0.0,
        "field_goals_at_rim_att": 0,
        "field_goals_at_rim_made": 0,
        "field_goals_at_rim_pct": 0.0,
        "field_goals_at_midrange_att": 0,
        "field_goals_at_midrange_made": 0,
        "field_goals_at_midrange_pct": 0.0,
        "efficiency": 8,
        "efficiency_game_score": 7.0,
        "true_shooting_att": 5.0,
        "true_shooting_pct": 90.0,
        "defensive_rating": 155.44283141196,
        "offensive_rating": 148.483244141445,
        "fast_break_pts": 0,
        "fast_break_att": 0,
        "fast_break_made": 0,
        "fast_break_pct": 0.0,
        "second_chance_att": 0,
        "second_chance_made": 0,
        "second_chance_pct": 0.0,
        "minus": 29,
        "plus": 21,
        "defensive_rebounds_pct": 0.0,
        "offensive_rebounds_pct": 0.0,
        "rebounds_pct": 0.0,
        "steals_pct": 0.0,
        "turnovers_pct": 0.0
      },
      {
        "id": "1ee26f39-344c-49ca-a6e5-2627a19fe8ec",
        "sequence": 3,
        "number": 3,
        "type": "REG",
        "minutes": "8:43",
        "field_goals_made": 0,
        "field_goals_att": 1,
        "field_goals_pct": 0.0,
        "effective_fg_pct": 0.0,
        "three_points_made": 0,
        "three_points_att": 0,
        "three_points_pct": 0.0,
        "two_points_made": 0,
        "two_points_att": 1,
        "two_points_pct": 0.0,
        "blocked_att": 0,
        "free_throws_made": 0,
        "free_throws_att": 0,
        "free_throws_pct": 0.0,
        "offensive_rebounds": 0,
        "defensive_rebounds": 1,
        "rebounds": 1,
        "assists": 0,
        "turnovers": 0,
        "steals": 0,
        "blocks": 0,
        "assists_turnover_ratio": 0.0,
        "fouls_drawn": 0,
        "personal_fouls": 1,
        "flagrant_fouls": 0,
        "tech_fouls": 1,
        "tech_fouls_non_unsportsmanlike": 1,
        "offensive_fouls": 0,
        "pls_min": 3,
        "points": 0,
        "second_chance_pts": 0,
        "points_off_turnovers": 0,
        "points_in_paint": 0,
        "points_in_paint_att": 1,
        "points_in_paint_made": 0,
        "points_in_paint_pct": 0.0,
        "field_goals_at_rim_att": 1,
        "field_goals_at_rim_made": 0,
        "field_goals_at_rim_pct": 0.0,
        "field_goals_at_midrange_att": 0,
        "field_goals_at_midrange_made": 0,
        "field_goals_at_midrange_pct": 0.0,
        "efficiency": -3,
        "efficiency_game_score": -0.8,
        "true_shooting_att": 1.0,
        "true_shooting_pct": 0.0,
        "defensive_rating": 146.59421169855,
        "offensive_rating": 0.0,
        "fast_break_pts": 0,
        "fast_break_att": 0,
        "fast_break_made": 0,
        "fast_break_pct": 0.0,
        "second_chance_att": 0,
        "second_chance_made": 0,
        "second_chance_pct": 0.0,
        "minus": 19,
        "plus": 22,
        "defensive_rebounds_pct": 19.6667577164709,
        "offensive_rebounds_pct": 0.0,
        "rebounds_pct": 8.60420650095602,
        "steals_pct": 0.0,
        "turnovers_pct": 0.0
      },
      {
        "id": "2f66c01b-a57d-4f59-88f4-abf11c668044",
        "sequence": 4,
        "number": 4,
        "type": "REG",
        "minutes": "6:26",
        "field_goals_made": 0,
        "field_goals_att": 2,
        "field_goals_pct": 0.0,
        "effective_fg_pct": 0.0,
        "three_points_made": 0,
        "three_points_att": 1,
        "three_points_pct": 0.0,
        "two_points_made": 0,
        "two_points_att": 1,
        "two_points_pct": 0.0,
        "blocked_att": 0,
        "free_throws_made": 0,
        "free_throws_att": 0,
        "free_throws_pct": 0.0,
        "offensive_rebounds": 0,
        "defensive_rebounds": 0,
        "rebounds": 0,
        "assists": 1,
        "turnovers": 0,
        "steals": 0,
        "blocks": 0,
        "assists_turnover_ratio": 0.0,
        "fouls_drawn": 1,
        "personal_fouls": 0,
        "flagrant_fouls": 0,
        "tech_fouls": 1,
        "tech_fouls_non_unsportsmanlike": 0,
        "offensive_fouls": 0,
        "pls_min": 1,
        "points": 0,
        "second_chance_pts": 0,
        "points_off_turnovers": 0,
        "points_in_paint": 0,
        "points_in_paint_att": 0,
        "points_in_paint_made": 0,
        "points_in_paint_pct": 0.0,
        "field_goals_at_rim_att": 0,
        "field_goals_at_rim_made": 0,
        "field_goals_at_rim_pct": 0.0,
        "field_goals_at_midrange_att": 1,
        "field_goals_at_midrange_made": 0,
        "field_goals_at_midrange_pct": 0.0,
        "efficiency": -1,
        "efficiency_game_score": -0.7,
        "true_shooting_att": 2.0,
        "true_shooting_pct": 0.0,
        "defensive_rating": 109.872527067485,
        "offensive_rating": 34.4498311309343,
        "fast_break_pts": 0,
        "fast_break_att": 0,
        "fast_break_made": 0,
        "fast_break_pct": 0.0,
        "second_chance_att": 1,
        "second_chance_made": 0,
        "second_chance_pct": 0.0,
        "minus": 12,
        "plus": 13,
        "defensive_rebounds_pct": 0.0,
        "offensive_rebounds_pct": 0.0,
        "rebounds_pct": 0.0,
        "steals_pct": 0.0,
        "turnovers_pct": 0.0
      }
    ]
  }
}

Update applies to: NBA v8, WNBA v8, NBA G League v8, NBA v7, WNBA v7, NBA G League v7, NBA v5, NBA G League v5, NBA v4, WNBA v4, WNBA v3