Football APIs - Support for Plays Under Review

We've added support to denote a play is under review during live full coverage games. This update is available going forward for all versions of the NFL, NCAA Football, and UFL APIs.

Each play will now include an official data point, denoting whether or not the play is under review.

If official="false", the play is currently under review
If official="true", then a determination on the play has been made

While a play is under review (official="false"), the statistics on a play will be nullified. If the play is upheld, the stats will be reinstated.

Additionally, while a play is under review, a new play segment category of review_pending populates. This play segment is temporary and is removed from the play once the review is finalized. See below for sample data of this behavior.

☑️ Sample Requests:

Game Play-by-Play (NFL) - https://api.sportradar.com/nfl/official/trial/v7/en/games/{game_id}/pbp.xml?api_key=?api_key=[API_KEY]

Game Play-by-Play (NCAAFB) - https://api.sportradar.com/ncaafb/trial/v7/en/games/{game_id}/boxscore.json?api_key=?api_key=[API_KEY]

🔢 Versions

🔁 Endpoints Affected

Game Boxscore, Game Play-by-Play, Push Events

⚙️ Return Sample

{
   "type":"play",
   "id":"bbff5bf0-05a6-11f0-b606-a5cf51051b41",
   "sequence":1742487421826,
   "clock":"11:46",
   "home_points":20,
   "away_points":13,
   "created_at":"2025-03-20T16:17:01+00:00",
   "updated_at":"2025-03-20T16:17:02+00:00",
   "play_type":"rush",
   "wall_clock":"2025-03-20T16:16:53+00:00",
   "source":"SRUS",
   "official":false,
   "fake_punt":false,
   "fake_field_goal":false,
   "screen_pass":false,
   "play_action":false,
   "run_pass_option":false,
   "start_situation":{
      "clock":"11:46",
      "down":1,
      "yfd":10,
      "possession":{
         "name":"Packers",
         "market":"Green Bay",
         "alias":"GB",
         "id":"a20471b4-a8d9-40c7-95ad-90cc30e46932"
      },
      "location":{
         "name":"Packers",
         "market":"Green Bay",
         "alias":"GB",
         "id":"a20471b4-a8d9-40c7-95ad-90cc30e46932",
         "yardline":30
      }
   },
   "end_situation":{
      "clock":"11:41",
      "down":0,
      "yfd":0,
      "possession":{
         "name":"Packers",
         "market":"Green Bay",
         "alias":"GB",
         "id":"a20471b4-a8d9-40c7-95ad-90cc30e46932"
      },
      "location":{
         "name":"Cowboys",
         "market":"Dallas",
         "alias":"DAL",
         "id":"e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
         "yardline":15
      }
   },
   "description":"A.Dillon rushed for 70 yards. TOUCHDOWN. Play is under review.",
   "statistics":[
      {
         "stat_type":"rush",
         "nullified":true,
         "attempt":1,
         "yards":70,
         "touchdown":1,
         "inside_20":0,
         "goaltogo":0,
         "broken_tackles":0,
         "kneel_down":0,
         "scramble":0,
         "team":{
            "name":"Packers",
            "market":"Green Bay",
            "alias":"GB",
            "id":"a20471b4-a8d9-40c7-95ad-90cc30e46932"
         },
         "player":{
            "name":"AJ Dillon",
            "jersey":"28",
            "id":"e10bfeb8-ea01-47bc-bfa8-45f6dcbf71b3",
            "position":"RB"
         }
      },
      {
         "stat_type":"first_down",
         "category":"rush",
         "nullified":true,
         "team":{
            "name":"Packers",
            "market":"Green Bay",
            "alias":"GB",
            "id":"a20471b4-a8d9-40c7-95ad-90cc30e46932"
         },
         "player":{
            "name":"AJ Dillon",
            "jersey":"28",
            "id":"e10bfeb8-ea01-47bc-bfa8-45f6dcbf71b3",
            "position":"RB"
         }
      }
   ],
   "details":[
      {
         "category":"rush",
         "description":"A.Dillon rushed for 70 yards.",
         "sequence":0,
         "start_location":{
            "name":"Packers",
            "market":"Green Bay",
            "alias":"GB",
            "id":"a20471b4-a8d9-40c7-95ad-90cc30e46932",
            "yardline":30
         },
         "end_location":{
            "name":"Cowboys",
            "market":"Dallas",
            "alias":"DAL",
            "id":"e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
            "yardline":0
         },
         "yards":70,
         "result":"touchdown",
         "players":[
            {
               "role":"rush",
               "name":"AJ Dillon",
               "jersey":"28",
               "id":"e10bfeb8-ea01-47bc-bfa8-45f6dcbf71b3",
               "position":"RB"
            }
         ]
      },
      {
         "category":"touchdown",
         "description":"TOUCHDOWN.",
         "sequence":1,
         "start_location":{
            "name":"Cowboys",
            "market":"Dallas",
            "alias":"DAL",
            "id":"e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
            "yardline":0
         },
         "end_location":{
            "name":"Cowboys",
            "market":"Dallas",
            "alias":"DAL",
            "id":"e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
            "yardline":0
         },
         "yards":70,
         "result":"touchdown",
         "players":[
            {
               "role":"rush",
               "name":"AJ Dillon",
               "jersey":"28",
               "id":"e10bfeb8-ea01-47bc-bfa8-45f6dcbf71b3",
               "position":"RB"
            }
         ]
      },
      {
         "category":"review_pending",
         "description":"Play is under review.",
         "sequence":2,
         "start_location":{
            "name":"Cowboys",
            "market":"Dallas",
            "alias":"DAL",
            "id":"e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
            "yardline":0
         },
         "end_location":{
            "name":"Cowboys",
            "market":"Dallas",
            "alias":"DAL",
            "id":"e627eec7-bbae-4fa4-8e73-8e1d6bc5c060",
            "yardline":0
         },
         "players":[
            
         ]
      }
   ]
}
]
}