---
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/sportradar-updates/llms.txt
---

# 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`

<br />

⭐ **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.

<br />

📋 **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.

<br />

☑️ **Sample Requests:**

**Game Boxscore (NFL)**

```curl cURL
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'
```

<br />

🔢 **Products**

| Sport             | Product                                                                                                                       | Version(s) |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------- |
| American Football | <Anchor target="_blank" href="https://developer.sportradar.com/football/reference/nfl-overview">NFL API</Anchor>              | v7         |
| American Football | <Anchor target="_blank" href="https://developer.sportradar.com/football/reference/ufl-overview">UFL API</Anchor>              | v7         |
| American Football | <Anchor target="_blank" href="https://developer.sportradar.com/football/reference/ncaafb-overview">NCAA Football API</Anchor> | v7         |

<br />

🔁 **Endpoints Affected**

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

<br />

⚙️ **Return Samples**

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

<br />