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.
Attribute – weather.stadium_status
Valid values – open, 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_statusattribute 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/closedvalue 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
| Sport | Product | Version(s) |
|---|---|---|
| American Football | NFL API | v7 |
| American Football | UFL API | v7 |
| American Football | NCAA Football API | v7 |
🔁 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"
}
},