Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

USFL Change Log

Find all updates to the USFL v7 API and its documentation

Push Statistics - Game Data

Release DateFeeds AffectedBenefit
06/05/2024Push StatisticsWe've added a number of game attributes to the Push Statistics feed.

These attributes can also be found in the RESTful Game Statistics endpoint and include, but are not limited to:

- Attendance
- Remaining Challenges
- Used Challenges
- Remaining Timeouts
- Used Timeouts
- Game Clock
- Game Duration
- Home/Away Id
- Home/Away Market
- Home/Away Name
- Home/Away SR Id
- Weather Info
- Season Id
- Season Name
- Season Type
- Season Year
- Week Id
- Week Sequence
- Week Title
- Venue Info

See below for sample data including the updated attributes.
{
   "payload":{
      "player":{
         "name":"Noah Gray",
         "jersey":"83",
         "id":"c97dfcb6-b999-476f-8487-f3848e92df17",
         "position":"TE",
         "sr_id":"sr:player:2197934"
      },
      "receiving":{
         "receptions":2,
         "targets":2,
         "yards":22,
         "avg_yards":11.0,
         "longest":12,
         "touchdowns":0,
         "yards_after_catch":14,
         "redzone_targets":0,
         "air_yards":8,
         "broken_tackles":0,
         "dropped_passes":0,
         "catchable_passes":0,
         "yards_after_contact":5,
         "firstdowns":1
      }
   },
   "locale":"en",
   "metadata":{
      "league":"nfl",
      "match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
      "status":"closed",
      "participant":"sd:player:c97dfcb6-b999-476f-8487-f3848e92df17,sr:player:2197934",
      "locale":"en",
      "operation":"update",
      "version":"v7"
   }
}{
   "payload":{
      "player":{
         "name":"Tommy Townsend",
         "jersey":"05",
         "id":"edfc712a-54f7-4c34-a838-c50c14dbf7dc",
         "position":"P",
         "sr_id":"sr:player:2040157"
      },
      "punts":{
         "attempts":5,
         "yards":254,
         "avg_yards":50.8,
         "blocked":0,
         "longest":62,
         "touchbacks":0,
         "inside_20":2,
         "avg_net_yards":50.8,
         "return_yards":0,
         "net_yards":254,
         "hang_time":25.048,
         "avg_hang_time":5.01
      }
   },
   "locale":"en",
   "metadata":{
      "league":"nfl",
      "match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
      "status":"closed",
      "participant":"sd:player:edfc712a-54f7-4c34-a838-c50c14dbf7dc,sr:player:2040157",
      "locale":"en",
      "operation":"update",
      "version":"v7"
   }
}{
   "payload":{
      "name":"Chiefs",
      "market":"Kansas City",
      "alias":"KC",
      "id":"902a4753-72f9-4868-9d9b-193a5c41ea4d",
      "title":"Super Bowl LVIII",
      "status":"closed",
      "coverage":"full",
      "neutral_site":true,
      "game_type":"playoff",
      "scheduled":"2024-02-11T23:30:00+00:00",
      "attendance":61629,
      "duration":"4:06",
      "entry_mode":"LDE",
      "wx_temp":54,
      "wx_humidity":26,
      "wx_wind_speed":6,
      "wx_wind_direction":"NE",
      "wx_condition":"Sunny",
      "weather":"Sunny Temp: 54 F, Humidity: 26%, Wind: NE 6 mph",
      "quarter":5,
      "clock":"00:03",
      "conference_game":false,
      "sr_id":"sr:match:46791617",
      "team":{
         "name":"Chiefs",
         "market":"Kansas City",
         "alias":"KC",
         "id":"6680d28d-d4d2-49f6-aace-5292d3ec02c2",
         "sr_id":"sr:competitor:4422"
      },
      "summary":{
         "possession_time":"36:26",
         "avg_gain":5.8,
         "safeties":0,
         "turnovers":2,
         "play_count":79,
         "rush_plays":30,
         "total_yards":455,
         "fumbles":5,
         "lost_fumbles":1,
         "penalties":6,
         "penalty_yards":55,
         "return_yards":12,
         "season":{
            "id":"736474f0-adc5-11ee-b174-6f0e0e094ae8",
            "year":2023,
            "type":"PST",
            "name":"PST"
         },
         "week":{
            "id":"8ece04d3-ed37-4ac0-a66b-5c0a1fdf99f3",
            "sequence":4,
            "title":"4"
         },
         "venue":{
            "id":"53d42601-5dfb-40a7-bd94-da2c1d3a75e4",
            "name":"Allegiant Stadium",
            "city":"Las Vegas",
            "state":"NV",
            "country":"USA",
            "zip":"89118",
            "address":"3333 Al Davis Way",
            "capacity":65000,
            "surface":"turf",
            "roof_type":"dome",
            "sr_id":"sr:venue:51543",
            "location":{
               "latitude":"36.090852",
               "longitude":"-115.183339"
            }
         },
         "home":{
            "name":"Chiefs",
            "market":"Kansas City",
            "alias":"KC",
            "used_timeouts":1,
            "remaining_timeouts":1,
            "used_challenges":0,
            "remaining_challenges":2,
            "id":"6680d28d-d4d2-49f6-aace-5292d3ec02c2",
            "points":25,
            "sr_id":"sr:competitor:4422",
            "record":{
               "wins":11,
               "losses":6,
               "ties":0
            }
         },
         "away":{
            "name":"49ers",
            "market":"San Francisco",
            "alias":"SF",
            "used_timeouts":1,
            "remaining_timeouts":1,
            "used_challenges":0,
            "remaining_challenges":2,
            "id":"f0e724b0-4cbf-495a-be47-013907608da9",
            "points":22,
            "sr_id":"sr:competitor:4389",
            "record":{
               "wins":12,
               "losses":5,
               "ties":0
            }
         }
      },
      "rushing":{
         "avg_yards":4.333,
         "attempts":30,
         "touchdowns":0,
         "tlost":1,
         "tlost_yards":-3,
         "yards":130,
         "longest":22,
         "redzone_attempts":5,
         "broken_tackles":2,
         "kneel_downs":0,
         "scrambles":6,
         "yards_after_contact":38,
         "firstdowns":9
      },
      "receiving":{
         "targets":42,
         "receptions":34,
         "avg_yards":9.794,
         "yards":333,
         "touchdowns":2,
         "yards_after_catch":184,
         "longest":52,
         "longest_touchdown":16,
         "redzone_targets":6,
         "air_yards":149,
         "broken_tackles":2,
         "dropped_passes":1,
         "catchable_passes":1,
         "yards_after_contact":41,
         "firstdowns":15
      },
      "punts":{
         "attempts":5,
         "yards":254,
         "net_yards":254,
         "blocked":0,
         "touchbacks":0,
         "inside_20":2,
         "return_yards":0,
         "avg_net_yards":50.8,
         "avg_yards":50.8,
         "longest":62,
         "hang_time":25.048,
         "avg_hang_time":5.01
      },
      "punt_returns":{
         "avg_yards":3.0,
         "returns":4,
         "yards":12,
         "longest":7,
         "touchdowns":0,
         "faircatches":0
      },
      "penalties":{
         "penalties":6,
         "yards":55,
         "firstdowns":3,
         "def_penalties":4,
         "def_penalty_yards":40,
         "off_penalties":2,
         "off_penalty_yards":15,
         "sp_penalties":0,
         "sp_penalty_yards":0
      },
      "passing":{
         "attempts":46,
         "completions":34,
         "cmp_pct":73.913,
         "interceptions":1,
         "sack_yards":8,
         "rating":99.3,
         "touchdowns":2,
         "avg_yards":6.633,
         "sacks":3,
         "longest":52,
         "longest_touchdown":16,
         "air_yards":149,
         "redzone_attempts":6,
         "throw_aways":4,
         "defended_passes":1,
         "dropped_passes":1,
         "spikes":0,
         "blitzes":7,
         "hurries":2,
         "knockdowns":4,
         "pocket_time":126.62199999999999,
         "avg_pocket_time":2.753,
         "poor_throws":6,
         "on_target_throws":35,
         "batted_passes":0,
         "firstdowns":15,
         "int_touchdowns":0,
         "net_yards":325,
         "yards":333
      },
      "misc_returns":{
         "returns":0,
         "yards":0,
         "touchdowns":0,
         "blk_fg_touchdowns":0,
         "blk_punt_touchdowns":0,
         "fg_return_touchdowns":0,
         "ez_rec_touchdowns":0,
         "blk_fg_yards":0,
         "blk_fg_returns":0,
         "blk_punt_yards":0,
         "blk_punt_returns":0,
         "fg_return_yards":0,
         "fg_return_returns":0
      },
      "kickoffs":{
         "kickoffs":7,
         "endzone":0,
         "inside_20":0,
         "return_yards":0,
         "returned":0,
         "touchbacks":7,
         "yards":455,
         "out_of_bounds":0,
         "onside_attempts":0,
         "onside_successes":0,
         "squib_kicks":0,
         "net_yards":280,
         "longest":65,
         "return_touchdowns":0
      },
      "kick_returns":{
         "avg_yards":0.0,
         "returns":0,
         "yards":0,
         "longest":0,
         "touchdowns":0,
         "faircatches":0
      },
      "int_returns":{
         "avg_yards":0.0,
         "returns":0,
         "yards":0,
         "touchdowns":0
      },
      "fumbles":{
         "fumbles":5,
         "lost_fumbles":1,
         "own_rec":4,
         "own_rec_yards":-10,
         "opp_rec":2,
         "opp_rec_yards":0,
         "out_of_bounds":0,
         "forced_fumbles":1,
         "own_rec_tds":0,
         "opp_rec_tds":0,
         "ez_rec_tds":0
      },
      "field_goals":{
         "attempts":4,
         "made":4,
         "blocked":0,
         "yards":138,
         "avg_yards":34.5,
         "longest":57,
         "attempts_19":0,
         "attempts_29":3,
         "attempts_39":0,
         "attempts_49":0,
         "attempts_50":1,
         "made_19":0,
         "made_29":3,
         "made_39":0,
         "made_49":0,
         "made_50":1,
         "missed":0
      },
      "extra_points":{
         "kick_attempts":1,
         "kick_blocked":0,
         "kick_made":1,
         "pass_conv_attempts":0,
         "pass_conv_successes":0,
         "rush_conv_attempts":0,
         "rush_conv_successes":0,
         "def_conv_attempts":0,
         "def_conv_successes":0,
         "missed":0,
         "pass_conv_three_point_attempts":0,
         "pass_conv_three_point_successes":0,
         "rush_conv_three_point_attempts":0,
         "rush_conv_three_point_successes":0,
         "def_conv_three_point_attempts":0,
         "def_conv_three_point_successes":0
      },
      "defense":{
         "tackles":33,
         "assists":41,
         "combined":74,
         "sacks":1.0,
         "sack_yards":4.0,
         "passes_defended":6,
         "forced_fumbles":1,
         "fumble_recoveries":1,
         "qb_hits":11,
         "tloss":4.0,
         "tloss_yards":15.0,
         "safeties":0,
         "sp_tackles":1,
         "sp_assists":0,
         "sp_forced_fumbles":0,
         "sp_fumble_recoveries":1,
         "sp_blocks":1,
         "misc_tackles":1,
         "misc_assists":0,
         "misc_forced_fumbles":0,
         "misc_fumble_recoveries":0,
         "def_targets":37,
         "def_comps":24,
         "blitzes":25,
         "hurries":0,
         "knockdowns":9,
         "missed_tackles":8,
         "batted_passes":2,
         "three_and_outs_forced":3,
         "fourth_down_stops":0,
         "def_yards_against":276,
         "field_goal_blocks":0,
         "punt_blocks":0,
         "extra_point_blocks":1,
         "def_touchdowns_against":2,
         "sp_opp_fumble_recoveries":0,
         "sp_own_fumble_recoveries":0,
         "number":0
      },
      "efficiency":{
         "goaltogo":{
            "attempts":3,
            "successes":1,
            "pct":33.333,
            "fg_successes":1,
            "td_successes":1
         },
         "redzone":{
            "attempts":6,
            "successes":2,
            "pct":33.333,
            "fg_successes":3,
            "td_successes":2
         },
         "thirddown":{
            "attempts":19,
            "successes":9,
            "pct":47.368
         },
         "fourthdown":{
            "attempts":1,
            "successes":1,
            "pct":100.0
         }
      },
      "first_downs":{
         "pass":15,
         "penalty":0,
         "rush":9,
         "total":24
      },
      "interceptions":{
         "return_yards":0,
         "returned":0,
         "number":0
      },
      "touchdowns":{
         "pass":2,
         "rush":0,
         "total_return":0,
         "total":2,
         "fumble_return":0,
         "int_return":0,
         "kick_return":0,
         "punt_return":0,
         "other":0
      }
   },
   "locale":"en",
   "metadata":{
      "league":"nfl",
      "match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
      "status":"closed",
      "participant":"sd:team:6680d28d-d4d2-49f6-aace-5292d3ec02c2,sr:competitor:4422",
      "locale":"en",
      "operation":"update",
      "version":"v7"
   }
}{
   "payload":{
      "player":{
         "name":"Leo Chenal",
         "jersey":"54",
         "id":"c7929fb3-5437-42cc-a3c2-10b73ebb1fa0",
         "position":"LB",
         "sr_id":"sr:player:1695607"
      },
      "fumbles":{
         "fumbles":0,
         "lost_fumbles":0,
         "own_rec":0,
         "own_rec_yards":0,
         "opp_rec":0,
         "opp_rec_yards":0,
         "out_of_bounds":0,
         "forced_fumbles":1,
         "own_rec_tds":0,
         "opp_rec_tds":0,
         "ez_rec_tds":0
      },
      "defense":{
         "tackles":3,
         "assists":3,
         "combined":6,
         "sacks":0.0,
         "sack_yards":0.0,
         "interceptions":0,
         "passes_defended":0,
         "forced_fumbles":1,
         "fumble_recoveries":0,
         "qb_hits":1,
         "tloss":1.0,
         "tloss_yards":8.0,
         "safeties":0,
         "sp_tackles":0,
         "sp_assists":0,
         "sp_forced_fumbles":0,
         "sp_fumble_recoveries":0,
         "sp_blocks":1,
         "misc_tackles":0,
         "misc_assists":0,
         "misc_forced_fumbles":0,
         "misc_fumble_recoveries":0,
         "def_targets":3,
         "def_comps":3,
         "blitzes":5,
         "hurries":0,
         "knockdowns":1,
         "missed_tackles":0,
         "batted_passes":0,
         "ast_sacks":0.0,
         "def_yards_against":4,
         "field_goal_blocks":0,
         "punt_blocks":0,
         "extra_point_blocks":1,
         "def_touchdowns_against":0
      }
   },
   "locale":"en",
   "metadata":{
      "league":"nfl",
      "match":"sd:match:902a4753-72f9-4868-9d9b-193a5c41ea4d,sr:match:46791617",
      "status":"closed",
      "participant":"sd:player:c7929fb3-5437-42cc-a3c2-10b73ebb1fa0,sr:player:1695607",
      "locale":"en",
      "operation":"update",
      "version":"v7"
   }
}


Play Detail - Force Fumble Assisted Tackle

Release DateFeeds AffectedBenefit
05/24/2024Game Boxscore

Play-by-Play

Push Events

Push Pulse
Added a new player role within play details called force_fum_ast.

This update returns a more improved stat calculation when a player is given an assisted tackle instead of a full tackle on a forced fumble.
<play id="57b09a80-c937-11ee-9cb4-01c7dabbaba5" sequence="1707695074699.0" clock="12:23" home_points="0" away_points="0" wall_clock="2024-02-11T23:43:50+00:00" men_in_box="8" fake_punt="false" fake_field_goal="false" screen_pass="false" blitz="false" play_direction="Right" left_tightends="0" right_tightends="2" hash_mark="Middle" qb_at_snap="Under Center" huddle="Huddle" running_lane="4" play_action="false" run_pass_option="false" created_at="2024-02-11T23:44:34+00:00" updated_at="2024-05-24T16:01:52+00:00" type="rush">
  <start_situation clock="12:23" down="1" yfd="10">
    <possession id="f0e724b0-4cbf-495a-be47-013907608da9" name="49ers" market="San Francisco" alias="SF" sr_id="sr:competitor:4389"/>
    <location id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422" yardline="29"/>
  </start_situation>
  <end_situation clock="12:15" down="1" yfd="10">
    <possession id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
    <location id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422" yardline="27"/>
  </end_situation>
  <description>C.McCaffrey rushed right guard to KC 27 for 2 yards. C.McCaffrey FUMBLES, forced by L.Chenal. Fumble RECOVERED by KC-G.Karlaftis at KC 27. </description>
  <statistics>
    <rush attempt="1" yards="2" firstdown="0" inside_20="0" goaltogo="0" broken_tackles="0" kneel_down="0" scramble="0">
      <team id="f0e724b0-4cbf-495a-be47-013907608da9" name="49ers" market="San Francisco" alias="SF" sr_id="sr:competitor:4389"/>
      <player id="f96db0af-5e25-42d1-a07a-49b4e065b364" name="Christian McCaffrey" jersey="23" position="RB" sr_id="sr:player:1129507"/>
    </rush>
    <fumble fumble="1" forced="1" lost="1">
      <team id="f0e724b0-4cbf-495a-be47-013907608da9" name="49ers" market="San Francisco" alias="SF" sr_id="sr:competitor:4389"/>
      <player id="f96db0af-5e25-42d1-a07a-49b4e065b364" name="Christian McCaffrey" jersey="23" position="RB" sr_id="sr:player:1129507"/>
    </fumble>
    <fumble opp_rec="1" opp_rec_yards="2" play_category="defense">
      <team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
      <player id="afb1f463-400e-4bdb-9028-717a563ba6f4" name="George Karlaftis" jersey="56" position="DE" sr_id="sr:player:1695453"/>
    </fumble>
    <fumble opp_rec_yards="-2" play_category="misc">
      <team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
      <player id="afb1f463-400e-4bdb-9028-717a563ba6f4" name="George Karlaftis" jersey="56" position="DE" sr_id="sr:player:1695453"/>
    </fumble>
    <defense ast_tackle="1" category="defense" def_target="0" def_comp="0" blitz="0" hurry="0" knockdown="0" batted_pass="0">
      <team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
      <player id="8b9bc551-66bb-4948-849f-c0471caaeb19" name="Mike Pennel" jersey="69" position="DT" sr_id="sr:player:854870"/>
    </defense>
    <defense ast_tackle="1" forced_fumble="1" category="defense" missed_tackles="0" def_target="0" def_comp="0" blitz="0" hurry="0" knockdown="0" batted_pass="0">
      <team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
      <player id="c7929fb3-5437-42cc-a3c2-10b73ebb1fa0" name="Leo Chenal" jersey="54" position="LB" sr_id="sr:player:1695607"/>
    </defense>
  </statistics>
  <details>
    <detail category="rush" sequence="0" direction="right guard" yards="2" result="fumbled">
      <description>C.McCaffrey rushed right guard to KC 27 for 2 yards.</description>
      <start_location alias="KC" yardline="29"/>
      <end_location alias="KC" yardline="27"/>
      <players>
        <player id="f96db0af-5e25-42d1-a07a-49b4e065b364" name="Christian McCaffrey" jersey="23" position="RB" sr_id="sr:player:1129507" role="rush"/>
      </players>
    </detail>
    <detail category="forced_fumble" sequence="1">
      <description>C.McCaffrey FUMBLES, forced by L.Chenal.</description>
      <start_location alias="KC" yardline="27"/>
      <end_location alias="KC" yardline="27"/>
      <players>
        <player id="f96db0af-5e25-42d1-a07a-49b4e065b364" name="Christian McCaffrey" jersey="23" position="RB" sr_id="sr:player:1129507" role="fumble"/>
        <player id="c7929fb3-5437-42cc-a3c2-10b73ebb1fa0" name="Leo Chenal" jersey="54" position="LB" sr_id="sr:player:1695607" role="force_fum_ast"/>
        <player id="8b9bc551-66bb-4948-849f-c0471caaeb19" name="Mike Pennel" jersey="69" position="DT" sr_id="sr:player:854870" role="ast_tackle"/>
      </players>
    </detail>
    <detail category="opponent_fumble_recovery" sequence="2">
      <description>Fumble RECOVERED by KC-G.Karlaftis at KC 27.</description>
      <start_location alias="KC" yardline="27"/>
      <end_location alias="KC" yardline="29"/>
      <recovery type="other_team">
        <team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
      </recovery>
      <players>
        <player id="afb1f463-400e-4bdb-9028-717a563ba6f4" name="George Karlaftis" jersey="56" position="DE" sr_id="sr:player:1695453" role="fum_rec"/>
      </players>
    </detail>
    <detail category="stat_correction" sequence="6">
      <description/>
      <start_location alias="KC" yardline="29"/>
      <end_location alias="KC" yardline="27"/>
      <players>
      </players>
    </detail>
  </details>
</play>
{
  "type": "play",
  "id": "57b09a80-c937-11ee-9cb4-01c7dabbaba5",
  "sequence": 1707695074699.0,
  "clock": "12:23",
  "home_points": 0,
  "away_points": 0,
  "play_type": "rush",
  "wall_clock": "2024-02-11T23:43:50+00:00",
  "description": "C.McCaffrey rushed right guard to KC 27 for 2 yards. C.McCaffrey FUMBLES, forced by L.Chenal. Fumble RECOVERED by KC-G.Karlaftis at KC 27. ",
  "men_in_box": 8,
  "fake_punt": false,
  "fake_field_goal": false,
  "screen_pass": false,
  "blitz": false,
  "play_direction": "Right",
  "left_tightends": 0,
  "right_tightends": 2,
  "hash_mark": "Middle",
  "qb_at_snap": "Under Center",
  "huddle": "Huddle",
  "running_lane": 4,
  "play_action": false,
  "run_pass_option": false,
  "created_at": "2024-02-11T23:44:34+00:00",
  "updated_at": "2024-05-24T16:01:52+00:00",
  "start_situation": {
    "clock": "12:23",
    "down": 1,
    "yfd": 10,
    "possession": {
      "id": "f0e724b0-4cbf-495a-be47-013907608da9",
      "name": "49ers",
      "market": "San Francisco",
      "alias": "SF",
      "sr_id": "sr:competitor:4389"
    },
    "location": {
      "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
      "name": "Chiefs",
      "market": "Kansas City",
      "alias": "KC",
      "sr_id": "sr:competitor:4422",
      "yardline": 29
    }
  },
  "end_situation": {
    "clock": "12:15",
    "down": 1,
    "yfd": 10,
    "possession": {
      "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
      "name": "Chiefs",
      "market": "Kansas City",
      "alias": "KC",
      "sr_id": "sr:competitor:4422"
    },
    "location": {
      "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
      "name": "Chiefs",
      "market": "Kansas City",
      "alias": "KC",
      "sr_id": "sr:competitor:4422",
      "yardline": 27
    }
  },
  "statistics": [
    {
      "stat_type": "rush",
      "attempt": 1,
      "yards": 2,
      "firstdown": 0,
      "inside_20": 0,
      "goaltogo": 0,
      "broken_tackles": 0,
      "kneel_down": 0,
      "scramble": 0,
      "player": {
        "id": "f96db0af-5e25-42d1-a07a-49b4e065b364",
        "name": "Christian McCaffrey",
        "jersey": "23",
        "position": "RB",
        "sr_id": "sr:player:1129507"
      },
      "team": {
        "id": "f0e724b0-4cbf-495a-be47-013907608da9",
        "name": "49ers",
        "market": "San Francisco",
        "alias": "SF",
        "sr_id": "sr:competitor:4389"
      }
    },
    {
      "stat_type": "fumble",
      "fumble": 1,
      "forced": 1,
      "lost": 1,
      "player": {
        "id": "f96db0af-5e25-42d1-a07a-49b4e065b364",
        "name": "Christian McCaffrey",
        "jersey": "23",
        "position": "RB",
        "sr_id": "sr:player:1129507"
      },
      "team": {
        "id": "f0e724b0-4cbf-495a-be47-013907608da9",
        "name": "49ers",
        "market": "San Francisco",
        "alias": "SF",
        "sr_id": "sr:competitor:4389"
      }
    },
    {
      "stat_type": "fumble",
      "opp_rec": 1,
      "opp_rec_yards": 2,
      "play_category": "defense",
      "player": {
        "id": "afb1f463-400e-4bdb-9028-717a563ba6f4",
        "name": "George Karlaftis",
        "jersey": "56",
        "position": "DE",
        "sr_id": "sr:player:1695453"
      },
      "team": {
        "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
        "name": "Chiefs",
        "market": "Kansas City",
        "alias": "KC",
        "sr_id": "sr:competitor:4422"
      }
    },
    {
      "stat_type": "fumble",
      "opp_rec_yards": -2,
      "play_category": "misc",
      "player": {
        "id": "afb1f463-400e-4bdb-9028-717a563ba6f4",
        "name": "George Karlaftis",
        "jersey": "56",
        "position": "DE",
        "sr_id": "sr:player:1695453"
      },
      "team": {
        "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
        "name": "Chiefs",
        "market": "Kansas City",
        "alias": "KC",
        "sr_id": "sr:competitor:4422"
      }
    },
    {
      "stat_type": "defense",
      "ast_tackle": 1,
      "category": "defense",
      "def_target": 0,
      "def_comp": 0,
      "blitz": 0,
      "hurry": 0,
      "knockdown": 0,
      "batted_pass": 0,
      "player": {
        "id": "8b9bc551-66bb-4948-849f-c0471caaeb19",
        "name": "Mike Pennel",
        "jersey": "69",
        "position": "DT",
        "sr_id": "sr:player:854870"
      },
      "team": {
        "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
        "name": "Chiefs",
        "market": "Kansas City",
        "alias": "KC",
        "sr_id": "sr:competitor:4422"
      }
    },
    {
      "stat_type": "defense",
      "ast_tackle": 1,
      "forced_fumble": 1,
      "category": "defense",
      "missed_tackles": 0,
      "def_target": 0,
      "def_comp": 0,
      "blitz": 0,
      "hurry": 0,
      "knockdown": 0,
      "batted_pass": 0,
      "player": {
        "id": "c7929fb3-5437-42cc-a3c2-10b73ebb1fa0",
        "name": "Leo Chenal",
        "jersey": "54",
        "position": "LB",
        "sr_id": "sr:player:1695607"
      },
      "team": {
        "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
        "name": "Chiefs",
        "market": "Kansas City",
        "alias": "KC",
        "sr_id": "sr:competitor:4422"
      }
    }
  ],
  "details": [
    {
      "category": "rush",
      "description": "C.McCaffrey rushed right guard to KC 27 for 2 yards.",
      "sequence": 0,
      "direction": "right guard",
      "yards": 2,
      "result": "fumbled",
      "start_location": {
        "alias": "KC",
        "yardline": 29
      },
      "end_location": {
        "alias": "KC",
        "yardline": 27
      },
      "players": [
        {
          "id": "f96db0af-5e25-42d1-a07a-49b4e065b364",
          "name": "Christian McCaffrey",
          "jersey": "23",
          "position": "RB",
          "sr_id": "sr:player:1129507",
          "role": "rush"
        }
      ]
    },
    {
      "category": "forced_fumble",
      "description": "C.McCaffrey FUMBLES, forced by L.Chenal.",
      "sequence": 1,
      "start_location": {
        "alias": "KC",
        "yardline": 27
      },
      "end_location": {
        "alias": "KC",
        "yardline": 27
      },
      "players": [
        {
          "id": "f96db0af-5e25-42d1-a07a-49b4e065b364",
          "name": "Christian McCaffrey",
          "jersey": "23",
          "position": "RB",
          "sr_id": "sr:player:1129507",
          "role": "fumble"
        },
        {
          "id": "c7929fb3-5437-42cc-a3c2-10b73ebb1fa0",
          "name": "Leo Chenal",
          "jersey": "54",
          "position": "LB",
          "sr_id": "sr:player:1695607",
          "role": "force_fum_ast"
        },
        {
          "id": "8b9bc551-66bb-4948-849f-c0471caaeb19",
          "name": "Mike Pennel",
          "jersey": "69",
          "position": "DT",
          "sr_id": "sr:player:854870",
          "role": "ast_tackle"
        }
      ]
    },
    {
      "category": "opponent_fumble_recovery",
      "description": "Fumble RECOVERED by KC-G.Karlaftis at KC 27.",
      "sequence": 2,
      "start_location": {
        "alias": "KC",
        "yardline": 27
      },
      "end_location": {
        "alias": "KC",
        "yardline": 29
      },
      "recovery": {
        "type": "other_team",
        "team": {
          "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
          "name": "Chiefs",
          "market": "Kansas City",
          "alias": "KC",
          "sr_id": "sr:competitor:4422"
        }
      },
      "players": [
        {
          "id": "afb1f463-400e-4bdb-9028-717a563ba6f4",
          "name": "George Karlaftis",
          "jersey": "56",
          "position": "DE",
          "sr_id": "sr:player:1695453",
          "role": "fum_rec"
        }
      ]
    },
    {
      "category": "stat_correction",
      "sequence": 6,
      "start_location": {
        "alias": "KC",
        "yardline": 29
      },
      "end_location": {
        "alias": "KC",
        "yardline": 27
      },
      "players": []
    }
  ]
}
]
},


TBD vs. TBD Support

Release DateFeeds AffectedBenefit
04/23/2024Current Season Schedule

Current Week Schedule

Season Schedule

Weekly Schedule
We are introducing support for Team TBD as a placeholder team.

This means you will now be able to obtain scheduled future games with known dates, even when one or both participants are yet to be determined.

See below for sample data.

<season xmlns="http://feed.elasticstats.com/schema/football/schedule-v7.0.xsd" id="e67a7c79-1e58-4334-b26e-7317d2efa16f" year="2024" type="PST" name="PST">
    <week id="73520b6b-5457-4cc5-bee6-d11ba1e9ebc1" sequence="1" title="1">
        <game id="304ec2bb-46c5-4c37-8712-d67786d09784" status="scheduled" scheduled="2024-06-08T19:00:00+00:00" entry_mode="LDE" game_type="playoff" conference_game="true" title="USFL Conference Final">
            <home id="11e96200-f058-11ee-ab1b-3fb8baf42b4f" name="Team TBD" alias="TBD"/>
            <away id="11e96200-f058-11ee-ab1b-3fb8baf42b4f" name="Team TBD" alias="TBD"/>
            <broadcast network="ABC"/>
        </game>
        <game id="ca05dd04-7bb9-4ed8-b164-75f2f5119bda" status="scheduled" scheduled="2024-06-09T23:00:00+00:00" entry_mode="LDE" game_type="playoff" conference_game="true" title="XFL Conference Final">
            <home id="11e96200-f058-11ee-ab1b-3fb8baf42b4f" name="Team TBD" alias="TBD"/>
            <away id="11e96200-f058-11ee-ab1b-3fb8baf42b4f" name="Team TBD" alias="TBD"/>
            <broadcast network="FOX"/>
        </game>
    </week>
    <week id="92c0953c-827b-4b11-ba25-57c6c868bdbf" sequence="2" title="2">
        <game id="9edd5ade-180d-4a18-aad5-2aa53c7e4d62" status="scheduled" scheduled="2024-06-16T21:00:00+00:00" entry_mode="LDE" neutral_site="true" game_type="playoff" conference_game="false" title="UFL Championship">
            <venue id="582c0e30-c046-11ee-8baf-e746db70974a" name="The Dome at America's Center" city="St. Louis" state="MO" country="USA" zip="63101" address="701 Convention Plaza" capacity="67277" surface="artificial" roof_type="dome" sr_id="sr:venue:8203">
      </venue>
            <home id="11e96200-f058-11ee-ab1b-3fb8baf42b4f" name="Team TBD" alias="TBD"/>
            <away id="11e96200-f058-11ee-ab1b-3fb8baf42b4f" name="Team TBD" alias="TBD"/>
            <broadcast network="FOX"/>
        </game>
    </week>
</season>
{
    "id": "e67a7c79-1e58-4334-b26e-7317d2efa16f",
    "year": 2024,
    "type": "PST",
    "name": "PST",
    "weeks": [
        {
            "id": "73520b6b-5457-4cc5-bee6-d11ba1e9ebc1",
            "sequence": 1,
            "title": "1",
            "games": [
                {
                    "id": "304ec2bb-46c5-4c37-8712-d67786d09784",
                    "status": "scheduled",
                    "scheduled": "2024-06-08T19:00:00+00:00",
                    "entry_mode": "LDE",
                    "game_type": "playoff",
                    "conference_game": true,
                    "title": "USFL Conference Final",
                    "home": {
                        "id": "11e96200-f058-11ee-ab1b-3fb8baf42b4f",
                        "name": "Team TBD",
                        "alias": "TBD"
                    },
                    "away": {
                        "id": "11e96200-f058-11ee-ab1b-3fb8baf42b4f",
                        "name": "Team TBD",
                        "alias": "TBD"
                    },
                    "broadcast": {
                        "network": "ABC"
                    }
                },
                {
                    "id": "ca05dd04-7bb9-4ed8-b164-75f2f5119bda",
                    "status": "scheduled",
                    "scheduled": "2024-06-09T23:00:00+00:00",
                    "entry_mode": "LDE",
                    "game_type": "playoff",
                    "conference_game": true,
                    "title": "XFL Conference Final",
                    "home": {
                        "id": "11e96200-f058-11ee-ab1b-3fb8baf42b4f",
                        "name": "Team TBD",
                        "alias": "TBD"
                    },
                    "away": {
                        "id": "11e96200-f058-11ee-ab1b-3fb8baf42b4f",
                        "name": "Team TBD",
                        "alias": "TBD"
                    },
                    "broadcast": {
                        "network": "FOX"
                    }
                }
            ]
        },
        {
            "id": "92c0953c-827b-4b11-ba25-57c6c868bdbf",
            "sequence": 2,
            "title": "2",
            "games": [
                {
                    "id": "9edd5ade-180d-4a18-aad5-2aa53c7e4d62",
                    "status": "scheduled",
                    "scheduled": "2024-06-16T21:00:00+00:00",
                    "entry_mode": "LDE",
                    "neutral_site": true,
                    "game_type": "playoff",
                    "conference_game": false,
                    "title": "UFL Championship",
                    "venue": {
                        "id": "582c0e30-c046-11ee-8baf-e746db70974a",
                        "name": "The Dome at America's Center",
                        "city": "St. Louis",
                        "state": "MO",
                        "country": "USA",
                        "zip": "63101",
                        "address": "701 Convention Plaza",
                        "capacity": 67277,
                        "surface": "artificial",
                        "roof_type": "dome",
                        "sr_id": "sr:venue:8203"
                    },
                    "home": {
                        "id": "11e96200-f058-11ee-ab1b-3fb8baf42b4f",
                        "name": "Team TBD",
                        "alias": "TBD"
                    },
                    "away": {
                        "id": "11e96200-f058-11ee-ab1b-3fb8baf42b4f",
                        "name": "Team TBD",
                        "alias": "TBD"
                    },
                    "broadcast": {
                        "network": "FOX"
                    }
                }
            ]
        }
    ],
}


Team Profile Enhancements

Release DateFeeds AffectedBenefit
09/20/2023League Hierarchy
Team Roster
Added several data points to team profiles.

New data includes:

- Year Founded
- Owner
- General Manager
- Team President
- Team Mascot
- Team Nicknames
- Fight Song
- Championships Won
- Championship Seasons
- Conference Titles
- Division Titles
- Playoff Appearances
<team id="c8797380-9677-11ec-9193-6b32ce92fd29" name="Maulers" market="Pittsburgh" alias="PIT"
      sr_id="sr:competitor:882423" founded="2022" owner="National Spring Football League Enterprises" 
      general_manager="Lonnie Young" mascot="Marty the Mauler" championships_won="0" conference_titles="1" 
      division_titles="1" playoff_appearances="1">
{
    "id": "c8797380-9677-11ec-9193-6b32ce92fd29",
    "name": "Maulers",
    "market": "Pittsburgh",
    "alias": "PIT",
    "sr_id": "sr:competitor:882423",
    "founded": 2022,
    "owner": "National Spring Football League Enterprises",
    "general_manager": "Lonnie Young",
    "mascot": "Marty the Mauler",
    "championships_won": 0,
    "conference_titles": 1,
    "division_titles": 1,
    "playoff_appearances": 1,
    "franchise": {
        "id": "d0ff2720-9677-11ec-9193-6b32ce92fd29",
        "name": "Maulers",
        "alias": "PIT"
    },


In-Game Player Status

Release DateFeeds AffectedBenefit
07/28/2023Game RosterAdded support for in-game player status updates. This will provide real-time updates due to injuries, benchings, and other status changes.

in_game_status will be present for each player in the Game Roster endpoint.

List of supported in-game statuses:
  • active
  • probable
  • questionable
  • doubtful
  • out
  • benched
  • unknown


Player Experience

Release DateFeeds AffectedBenefit
07/28/2023Player Profile
Team Roster
Added experience for player profiles.

This new attribute will represent the number of years active in the USFL for a player.


'Suspended' Game Status

Release DateFeeds AffectedBenefit
07/28/2023Current Season Schedule
Current Week Schedule
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Season Schedule
Weekly Schedule
Push Events
Added “suspended” as a valid game status.

suspended = The game has been suspended and will be rescheduled in the future, continuing where they left off. The game ID will remain the same.


Jersey Number Support

Release DateFeeds AffectedBenefit
07/28/2023Daily Transactions
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Profile
Team Roster
Weekly Depth Charts
Weekly Injuries
Push Events
Push Statistics
Adjusted logic to account for players without jersey numbers.

Players are no longer required to have a jersey number (player.jersey) present. Previously, players without a number were given 0.


Current Season and Current Week Endpoints

Release DateFeeds AffectedBenefit
07/18/2023Current Season Schedule
Current Week Schedule
Added two new endpoints: Current Season Schedule and Current Week Schedule.

Request these endpoints during an active season to retrieve the current week and/or season schedule information.


Comprehensive Drive Data

Release DateFeeds AffectedBenefit
05/16/2023Play-by-PlayAdded several data points to drives within the Play-by-Play endpoint.

New data points include:
  • team_sequence (the team's drive number)
  • start_clock (start time of a drive)
  • end_clock (end time of a drive)
  • first_drive_yardline (starting yardline of the first play of a drive, 1-99 scale)
  • last_drive_yardline (starting yardline of the last play of a drive, 1-99 scale)
  • net_yards (yards gained minus penalty yards)
  • pat_successful (whether there was a successful point after attempt on a drive)
  • pat_points_attempted (whether a PAT was attempted)
  • offensive_team - points (indicates how many points the offensive team scored on a drive)
  • offensive_team - id (indicates the offensive team on a drive)
  • defensive_team - points (indicates how many points the defensive team scored on a drive)
  • defensive_team - id (indicates the defensive team on a drive)


Conference Games Support

Release DateFeeds AffectedBenefit
05/16/2023Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Season Schedule
Weekly Schedule
Included a Boolean value (conference_game) for all game and schedule endpoints.

When true, this will indicate a game is a conference matchup.


Efficiency Metrics for Alternate Kickoffs

Release DateFeeds AffectedUpdate
03/20/2023Game Statistics
Season Statistics
Added efficiency metrics for 4th and 12 plays (aka Alternative Kickoffs).

These metrics (attempts, conversions, percentage) are provided under onside_scrimmage within Game Statistics and Season Statistics.


Daily Transactions Endpoint

Release DateFeeds AffectedUpdate
03/08/2023Daily TransactionsAdded a new Daily Transactions endpoint.

This new endpoint provides information for all USFL roster transactions added or edited during a league-defined day.


Fourth Down Stops & Three and Outs Forced

Release DateFeeds AffectedBenefit
09/09/2022Game Statistics
Seasonal Statistics
Push Statistics
Added data to support defensive fourth down stops and three and outs forced on a game and season level.

This new team stat will be available going forward in Game Statistics, Seasonal Statistics, and Push Statistics feeds.


First Down Statistics

Release DateFeeds AffectedBenefit
08/30/2022Game Statistics
Player Profile
Seasonal Statistics
Push Statistics
Added player first downs to rushing, passing, and receiving stat categories.


Interception for a TD Attribute

Release DateFeeds AffectedBenefit
08/30/2022Game Boxscore
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Push Events
Push Statistics
Added an interception touchdown attribute to quarterback passing statistics. With this update users can now credit a 'pick six' to the quarterback at the game and season level.


Drive Start/End Reasons

Release DateFeeds AffectedBenefit
08/15/2022Game Boxscore
Play-by-Play
Push Events
Added support for missing drive reasons in the play-by-play data. This improvement includes Muffed Punt (start reason), Muffed Kickoff (start reason), and Missed FG (end reason).


'Defensive Lineman' Position Added

Release DateFeeds AffectedBenefit
08/15/2022Daily Change Log
Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Player Profile
Seasonal Statistics
Team Roster
Push Events
Push Statistics
Added support for a new position: Defensive Lineman.


Game Duration Data Point

Release DateFeeds AffectedBenefit
08/15/2022Game Boxscore
Game Roster
Game Statistics
Play-by-Play
Season Schedule
Weekly Schedule
Push Events
Push Statistics
Added a game duration (length of the game in H:MM) value to all game-related endpoints.


Added USFL-Specific Statistics

Release DateFeeds AffectedUpdate
03/15/2022Play-by-PlayAdded support for special USFL rules - alternate kickoff, 3-point conversions, and overtime shootouts.


Initial Release

Release DateFeeds AffectedUpdate
03/03/2022AllSportradar is the official data provider of the new USFL! The USFL API offers real-time play-by-play updates, with a comprehensive suite of game and seasonal stats.