Release Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NBA, WNBA, G League APIs

Technical Foul Update

Release DateFeeds
Affected
Benefit
12/19/2023Game Boxscore

Game Summary

League
Leaders

Play-by-Play

Player Profile

Push Events

Push Statistics

Seasonal
Statistics

Series Statistics

Splits
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