GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

US Football APIs – Retractable Roof Status

We've added a stadium_status attribute to our US football APIs (NFL, NCAA Football, UFL) that indicates whether a stadium's retractable roof was open or closed during an event.

The attribute appears inside the weather object and is available in the Game Boxscore, Game Play-by-Play, and Game Statistics endpoints. It is absent when not applicable (for example, stadiums without a retractable roof).

This data is available going forward only. Games played before this release will not be backfilled with stadium_status.

Attributeweather.stadium_status

Valid valuesopen, closed


Benefit

Get a clearer picture of on-field environmental conditions by knowing whether a retractable roof was open or closed. This helps when analyzing team or player performance in indoor versus outdoor conditions.


📋 Recommended Actions

  • Read the new weather.stadium_status attribute from the Game Boxscore, Play-by-Play, and Statistics endpoints.
  • Treat the attribute as optional — handle its absence gracefully for stadiums where a retractable roof does not apply.
  • Use the open / closed value to distinguish indoor versus outdoor conditions in your performance or weather-based analysis.

☑️ Sample Requests:

Game Boxscore (NFL)

curl --request GET \
     --url https://api.sportradar.com/nfl/official/trial/v7/en/games/b2a90b75-17a7-42eb-9ea9-380da8b24248/boxscore.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
American FootballNFL APIv7
American FootballUFL APIv7
American FootballNCAA Football APIv7

🔁 Endpoints Affected

  • Game Boxscore
  • Game Play-by-Play
  • Game Statistics
  • Push Events
  • Push Statistics

⚙️ Return Samples

"weather": {
    "condition": "Controlled Climate",
    "humidity": 59,
    "temp": 57,
    "stadium_status": "closed",
    "wind": {
        "speed": 6,
        "direction": "NW"
    }
},