Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

UFL Change Log

Find all updates to the UFL v7 API and its documentation

Integration Guide

🗓️ Release Date 08/31/2026

A new Integration Guide is now available for the UFL API.

Benefit

The guide pairs step-by-step integration scenarios (schedules, live game tracking, standings, rosters and players, seasonal statistics, playoffs, and change monitoring) with UFL fundamentals, a canonical Game Status Workflow reference, Push feed integration, per-feed update frequencies, and workflow diagrams.

🏈 Recommended Actions

  • Start with the Overview for the guide map and a recommended reading order
  • Read UFL Fundamentals for the season model, league structure, and what changes coming from the NFL API
  • Use the Game Status Workflow page as the canonical reference when building state machines or notification logic; treat closed and cancelled as the only terminal statuses
  • Size polling against the Update Frequencies chart and drive live polling from the game status
  • Follow the Integration Scenarios that match your use case for end-to-end workflows with request and response examples

📄Documentation:



Retractable Roof Status

🗓️ Release Date 07/16/2026

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

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


Deleted Games

🗓️ Release Date 07/09/2026

We've added support for deleted games in the latest versions of our US football APIs (NFL, NCAA Football, UFL).

Previously, deleted games were fully removed from the API. Now, when a game is removed from our coverage (for example, a duplicate or erroneously created game), it will remain available with:

  • "deleted": true at the game level
  • A "deleted_games" array within Schedule endpoints
  • A deleted_games node added to the Daily Change Log feed

Benefit

Track and store deleted game IDs within your system to prevent mis-categorization or unintended downstream processing.

📋 Recommended Actions

  • Update your Schedule and Daily Change Log ingestion to read the new deleted flag and deleted_games array/node.
  • Store deleted game IDs so your system can suppress or reconcile them, rather than treating a previously-valid game as still active.
  • Confirm your downstream processing (stats, standings, displays) excludes games flagged as deleted.

☑️ Sample Requests:

Season Schedule (NCAA Football)

curl --request GET \
     --url https://api.sportradar.com/ncaafb/trial/v7/en/games/2026/REG/schedule.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

  • Daily Change Log
  • Game Boxscore, Game Play-by-Play, Game Roster, Game Statistics
  • Season Schedule, Weekly Schedule

⚙️ Return Samples

Click here to download a zip file including several sample feeds of deleted games.



Fumbles Lost on Rushes and Receptions

🗓️ Release Date 07/02/2026

We've added two new data points to capture fumbles lost on rushing and receiving plays across all three of our football APIs (NFL, NCAA Football, and UFL).

Going forward, fumbles lost on rushes (rushing_lost_fumbles) and receptions (receiving_lost_fumbles) will be available at the game and season level, for players and teams.

Both fields appear on the fumbles element at the team level and within each nested player element.

Benefit

Use these new data points to build a more complete picture of fumble activity, and incorporate them into your player and team profiles or fantasy scoring calculations.

📋 Recommended Actions

  • Add the rushing_lost_fumbles and receiving_lost_fumbles fields to your game and seasonal statistics ingestion for NFL, NCAA Football, and UFL.
  • Update player and team profiles to surface the new play-type fumble breakdowns.
  • If you calculate fantasy or performance scores, incorporate the new fields where lost-fumble detail is relevant.

☑️ Sample Requests:

Game Statistics

curl --request GET \
     --url https://api.sportradar.com/nfl/official/trial/v7/en/games/9a2084f0-146c-417c-a94d-b26012539d1e/statistics.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Versions

🔁 Endpoints Affected

  • Game Statistics (Player & Team)
  • Seasonal Statistics (Player, Team, & Opponent)
  • Push Statistics (Player & Team)

⚙️ Return Samples

Return Samples
<fumbles fumbles="5" lost_fumbles="3" own_rec="2" own_rec_yards="0" opp_rec="0" opp_rec_yards="0" out_of_bounds="0" forced_fumbles="0" own_rec_tds="0" opp_rec_tds="0" ez_rec_tds="0" rushing_lost_fumbles="1" receiving_lost_fumbles="0">
    <player id="ce5de0e5-9f76-42ee-b93a-3ef88af9b0a7" name="James Cook III" jersey="04" position="RB" sr_id="sr:player:1415199" fumbles="1" lost_fumbles="1" own_rec="0" own_rec_yards="0" opp_rec="0" opp_rec_yards="0" out_of_bounds="0" forced_fumbles="0" own_rec_tds="0" opp_rec_tds="0" ez_rec_tds="0" rushing_lost_fumbles="1" receiving_lost_fumbles="0"/>


Overtime Drive Reason

🗓️ Release Date 05/06/2026

We’ve added a new start_reason value: Overtime Possession to the NCAA Football API and UFL APIs.

This value is used when a drive begins as part of an overtime possession.

See our FAQ for a complete list of drive start and end reasons.

Benefit

Clearly identifies the start of overtime drives, which do not begin with a kickoff in NCAA Football or UFL.

Return Samples
{
    "type": "drive",
    "id": "12a1cebd-dddc-41b4-9b48-bc2c08103e89",
    "sequence": 24,
    "start_reason": "Overtime Possession",
    "end_reason": "Field Goal",
    "play_count": 4

☑️ Sample Requests:

Game Play-by-Play

curl --request GET \
     --url https://api.sportradar.com/ncaafb/trial/v7/en/games/{game_id}/pbp.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Versions

🔁 Endpoints Affected

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

⚙️ Return Samples

Return Samples
<play-by-play>
    <drive id="12a1cebd-dddc-41b4-9b48-bc2c08103e89" sequence="24" start_reason="Overtime Possession" end_reason="Field Goal" play_count="4" duration="00:00" first_downs="0" gain="7" penalty_yards="0" inside_20="true" scoring_drive="true" created_at="2025-11-01T22:49:17+00:00" updated_at="2026-05-06T18:53:27+00:00" team_sequence="13" start_clock="00:00" end_clock="00:00" first_drive_yardline="25" last_drive_yardline="18" farthest_drive_yardline="18" net_yards="7" pat_points_attempted="0">
        <offensive_team points="3" id="1cdf66a2-f157-4b4f-ad37-bd31e268f0ae"/>
        <defensive_team points="0" id="709c25ab-2674-4d9f-9571-69c5ee9363b6"/>
        <play id="5403f440-b774-11f0-9c3a-2f5f4aec4c02" sequence="1762037357878.0" clock="00:00" home_points="17" away_points="17" wall_clock="2025-11-01T22:48:59+00:00" fake_punt="false" fake_field_goal="false" screen_pass="false" play_action="false" run_pass_option="false" created_at="2025-11-01T22:49:17+00:00" updated_at="2026-05-06T18:47:40+00:00" official="true" type="pass">
            <start_situation clock="00:00" down="1" yfd="10">
                <possession id="1cdf66a2-f157-4b4f-ad37-bd31e268f0ae" name="Spartans" market="Michigan State" alias="MSU"/>
                <location id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" market="Minnesota" alias="MINN" yardline="25"/>
            </start_situation>
            <end_situation clock="00:00" down="2" yfd="4">
                <possession id="1cdf66a2-f157-4b4f-ad37-bd31e268f0ae" name="Spartans" market="Michigan State" alias="MSU"/>
                <location id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" market="Minnesota" alias="MINN" yardline="19"/>
            </end_situation>
            <description>A.Milivojevic pass complete. Catch made by O.Kelly for 6 yards. Pushed out of bounds by J.McMillan at MINN 19.</description>
            <statistics>
                <pass attempt="1" complete="1" yards="6" att_yards="0" firstdown="0" inside_20="0" goaltogo="0">
                    <team id="1cdf66a2-f157-4b4f-ad37-bd31e268f0ae" name="Spartans" market="Michigan State" alias="MSU"/>
                    <player id="c41a28c0-dd8d-11ee-8df1-29e8b19e65cc" name="Alessio Milivojevic" jersey="11" position="QB"/>
                </pass>
                <receive firstdown="0" target="1" reception="1" yards="6" yards_after_catch="6" inside_20="0" goaltogo="0">
                    <team id="1cdf66a2-f157-4b4f-ad37-bd31e268f0ae" name="Spartans" market="Michigan State" alias="MSU"/>
                    <player id="eabad6c0-901c-11ec-8556-6fa97bcffaf0" name="Omari Kelly" jersey="01" position="WR"/>
                </receive>
                <defense tackle="1" category="defense">
                    <team id="709c25ab-2674-4d9f-9571-69c5ee9363b6" name="Golden Gophers" market="Minnesota" alias="MINN"/>
                    <player id="593cf4c4-a9cf-4f7c-bebd-36e37b478422" name="Jai'Onte' McMillan" jersey="24" position="DB"/>
                </defense>
            </statistics>
            <details>
                <detail category="pass_completion" sequence="0" yards="6">
                    <description>A.Milivojevic pass complete.</description>
                    <start_location alias="MINN" yardline="25"/>
                    <end_location alias="MINN" yardline="25"/>
                    <players>
                        <player id="c41a28c0-dd8d-11ee-8df1-29e8b19e65cc" name="Alessio Milivojevic" jersey="11" position="QB" role="pass"/>
                    </players>
                </detail>
                <detail category="pass_reception" sequence="1" yards="6" result="pushed out of bounds">
                    <description>Catch made by O.Kelly for 6 yards.</description>
                    <start_location alias="MINN" yardline="25"/>
                    <end_location alias="MINN" yardline="19"/>
                    <players>
                        <player id="eabad6c0-901c-11ec-8556-6fa97bcffaf0" name="Omari Kelly" jersey="01" position="WR" role="catch"/>
                    </players>
                </detail>
                <detail category="pushed_out_of_bounds" sequence="2">
                    <description>Pushed out of bounds by J.McMillan at MINN 19.</description>
                    <start_location alias="MINN" yardline="19"/>
                    <end_location alias="MINN" yardline="19"/>
                    <players>
                        <player id="593cf4c4-a9cf-4f7c-bebd-36e37b478422" name="Jai'Onte' McMillan" jersey="24" position="DB" role="tackle"/>
                    </players>
                </detail>
            </details>
        </play>
"pbp": [
    {
        "type": "drive",
        "id": "12a1cebd-dddc-41b4-9b48-bc2c08103e89",
        "sequence": 24,
        "start_reason": "Overtime Possession",
        "end_reason": "Field Goal",
        "play_count": 4,
        "duration": "00:00",
        "first_downs": 0,
        "gain": 7,
        "penalty_yards": 0,
        "inside_20": true,
        "scoring_drive": true,
        "created_at": "2025-11-01T22:49:17+00:00",
        "updated_at": "2026-05-06T18:53:27+00:00",
        "team_sequence": 13,
        "start_clock": "00:00",
        "end_clock": "00:00",
        "first_drive_yardline": 25,
        "last_drive_yardline": 18,
        "farthest_drive_yardline": 18,
        "net_yards": 7,
        "pat_points_attempted": 0,
        "offensive_team": {
            "points": 3,
            "id": "1cdf66a2-f157-4b4f-ad37-bd31e268f0ae"
        },
        "defensive_team": {
            "points": 0,
            "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6"
        },
        "events": [
            {
                "type": "play",
                "id": "5403f440-b774-11f0-9c3a-2f5f4aec4c02",
                "sequence": 1762037357878.0,
                "clock": "00:00",
                "home_points": 17,
                "away_points": 17,
                "play_type": "pass",
                "wall_clock": "2025-11-01T22:48:59+00:00",
                "description": "A.Milivojevic pass complete. Catch made by O.Kelly for 6 yards. Pushed out of bounds by J.McMillan at MINN 19.",
                "fake_punt": false,
                "fake_field_goal": false,
                "screen_pass": false,
                "play_action": false,
                "run_pass_option": false,
                "created_at": "2025-11-01T22:49:17+00:00",
                "updated_at": "2026-05-06T18:47:40+00:00",
                "official": true,
                "start_situation": {
                    "clock": "00:00",
                    "down": 1,
                    "yfd": 10,
                    "possession": {
                        "id": "1cdf66a2-f157-4b4f-ad37-bd31e268f0ae",
                        "name": "Spartans",
                        "market": "Michigan State",
                        "alias": "MSU"
                    },
                    "location": {
                        "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
                        "name": "Golden Gophers",
                        "market": "Minnesota",
                        "alias": "MINN",
                        "yardline": 25
                    }
                },
                "end_situation": {
                    "clock": "00:00",
                    "down": 2,
                    "yfd": 4,
                    "possession": {
                        "id": "1cdf66a2-f157-4b4f-ad37-bd31e268f0ae",
                        "name": "Spartans",
                        "market": "Michigan State",
                        "alias": "MSU"
                    },
                    "location": {
                        "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
                        "name": "Golden Gophers",
                        "market": "Minnesota",
                        "alias": "MINN",
                        "yardline": 19
                    }
                },
                "statistics": [
                    {
                        "stat_type": "pass",
                        "attempt": 1,
                        "complete": 1,
                        "yards": 6,
                        "att_yards": 0,
                        "firstdown": 0,
                        "inside_20": 0,
                        "goaltogo": 0,
                        "player": {
                            "id": "c41a28c0-dd8d-11ee-8df1-29e8b19e65cc",
                            "name": "Alessio Milivojevic",
                            "jersey": "11",
                            "position": "QB"
                        },
                        "team": {
                            "id": "1cdf66a2-f157-4b4f-ad37-bd31e268f0ae",
                            "name": "Spartans",
                            "market": "Michigan State",
                            "alias": "MSU"
                        }
                    },
                    {
                        "stat_type": "receive",
                        "firstdown": 0,
                        "target": 1,
                        "reception": 1,
                        "yards": 6,
                        "yards_after_catch": 6,
                        "inside_20": 0,
                        "goaltogo": 0,
                        "player": {
                            "id": "eabad6c0-901c-11ec-8556-6fa97bcffaf0",
                            "name": "Omari Kelly",
                            "jersey": "01",
                            "position": "WR"
                        },
                        "team": {
                            "id": "1cdf66a2-f157-4b4f-ad37-bd31e268f0ae",
                            "name": "Spartans",
                            "market": "Michigan State",
                            "alias": "MSU"
                        }
                    },
                    {
                        "stat_type": "defense",
                        "tackle": 1,
                        "category": "defense",
                        "player": {
                            "id": "593cf4c4-a9cf-4f7c-bebd-36e37b478422",
                            "name": "Jai'Onte' McMillan",
                            "jersey": "24",
                            "position": "DB"
                        },
                        "team": {
                            "id": "709c25ab-2674-4d9f-9571-69c5ee9363b6",
                            "name": "Golden Gophers",
                            "market": "Minnesota",
                            "alias": "MINN"
                        }
                    }
                ],
                "details": [
                    {
                        "category": "pass_completion",
                        "description": "A.Milivojevic pass complete.",
                        "sequence": 0,
                        "yards": 6,
                        "start_location": {
                            "alias": "MINN",
                            "yardline": 25
                        },
                        "end_location": {
                            "alias": "MINN",
                            "yardline": 25
                        },
                        "players": [
                            {
                                "id": "c41a28c0-dd8d-11ee-8df1-29e8b19e65cc",
                                "name": "Alessio Milivojevic",
                                "jersey": "11",
                                "position": "QB",
                                "role": "pass"
                            }
                        ]
                    },
                    {
                        "category": "pass_reception",
                        "description": "Catch made by O.Kelly for 6 yards.",
                        "sequence": 1,
                        "yards": 6,
                        "result": "pushed out of bounds",
                        "start_location": {
                            "alias": "MINN",
                            "yardline": 25
                        },
                        "end_location": {
                            "alias": "MINN",
                            "yardline": 19
                        },
                        "players": [
                            {
                                "id": "eabad6c0-901c-11ec-8556-6fa97bcffaf0",
                                "name": "Omari Kelly",
                                "jersey": "01",
                                "position": "WR",
                                "role": "catch"
                            }
                        ]
                    },
                    {
                        "category": "pushed_out_of_bounds",
                        "description": "Pushed out of bounds by J.McMillan at MINN 19.",
                        "sequence": 2,
                        "start_location": {
                            "alias": "MINN",
                            "yardline": 19
                        },
                        "end_location": {
                            "alias": "MINN",
                            "yardline": 19
                        },
                        "players": [
                            {
                                "id": "593cf4c4-a9cf-4f7c-bebd-36e37b478422",
                                "name": "Jai'Onte' McMillan",
                                "jersey": "24",
                                "position": "DB",
                                "role": "tackle"
                            }
                        ]
                    }
                ]
            },


Team Colors Added to League Hierarchy

🗓️ Release Date 03/30/2026

We’ve added Team Colors to the League Hierarchy feed for UFL.

Each team may now include a team_colors collection containing one or more team_color objects, with both HEX and RGB values for primary and secondary colors.

Benefit

Easily retrieve and display official team branding colors to enhance UI elements such as scoreboards, team pages, and visualizations.

☑️ Sample Requests:

  • League Hierarchy:

    https://api.sportradar.com/ufl/{access_level}/v7/{language_code}/league/hierarchy.{format}

🔢 Versions

  • All versions

🔁 Endpoints Affected

  • League Hierarchy

⚙️ Return Samples

Return Samples
 <team id="e3702f00-b8ef-11f0-9440-2f32b8d49d12" name="Aviators" market="Columbus" alias="CLB" sr_id="sr:competitor:1320802" founded="2026" owner="Fox/RedBird Capital Partners">
        <franchise id="f2638bb0-b8ef-11f0-9440-2f32b8d49d12" name="Aviators" alias="CLB"/>
        <venue id="3a767930-b8f0-11f0-8d80-75dca144275c" name="Historic Crew Stadium" city="Columbus" state="OH" country="USA" zip="43211" address="One Black and Gold Blvd" capacity="19968" surface="turf" roof_type="outdoor" sr_id="sr:venue:2296">
          <location lat="40.007561" lng="-82.992538"/>
        </venue>
        <team_colors>
          <team_color type="primary" hex_color="#0c2340">
            <rgb_color red="12" green="35" blue="64"/>
          </team_color>
          <team_color type="secondary" hex_color="#69b3e7">
            <rgb_color red="105" green="179" blue="231"/>
          </team_color>
        </team_colors>
      </team>
 {
              "id": "e3702f00-b8ef-11f0-9440-2f32b8d49d12",
              "name": "Aviators",
              "market": "Columbus",
              "alias": "CLB",
              "sr_id": "sr:competitor:1320802",
              "founded": 2026,
              "owner": "Fox/RedBird Capital Partners",
              "venue": {
                "id": "3a767930-b8f0-11f0-8d80-75dca144275c",
                "name": "Historic Crew Stadium",
                "city": "Columbus",
                "state": "OH",
                "country": "USA",
                "zip": "43211",
                "address": "One Black and Gold Blvd",
                "capacity": 19968,
                "surface": "turf",
                "roof_type": "outdoor",
                "sr_id": "sr:venue:2296",
                "location": {
                  "lat": "40.007561",
                  "lng": "-82.992538"
                }
              },
              "franchise": {
                "id": "f2638bb0-b8ef-11f0-9440-2f32b8d49d12",
                "name": "Aviators",
                "alias": "CLB"
              },
              "team_colors": [
                {
                  "type": "primary",
                  "hex_color": "#0c2340",
                  "rgb_color": {
                    "red": 12,
                    "green": 35,
                    "blue": 64
                  }
                },
                {
                  "type": "secondary",
                  "hex_color": "#69b3e7",
                  "rgb_color": {
                    "red": 105,
                    "green": 179,
                    "blue": 231
                  }
                }
              ]
            },


Four-Point Field Goals

🗓️ Release Date 03/17/2026

We’ve added support for the UFL's new Four-Point Field Goal rule. Any successful field goal kick from 60 yards or further will be worth four points. Updates include:

🏈 New attempt and made data points to capture four-point attempts

  • attempts_60 – Attempts of 60 yards or more
  • made_60 – Successful field goals of 60 yards or more
  • attempts_50 and made_50 continue to represent field goals attempted/made of 50 yards or more
  • Available for the 2026 season at the Game (Game Statistics) and Season (Player Profile, Seasonal Statistics) level for players and teams

🏈 A new play detail category of field_goal_four_point for each attempted four-point field goal in the Game Play-by-Play endpoint

Return Samples
          "details": [
            {
              "category": "field_goal_four_point",
              "description": "T.Brown 83 yard four-point field goal attempt is good, Center-LOU, Holder-LOU.",
              "sequence": 0,
              "yards": 83,
              "result": "good",
              "start_location": {
                "alias": "LOU",
                "yardline": 27
              },
              "end_location": {
                "alias": "LOU",
                "yardline": 27
              },
              "players": [
                {
                  "id": "9089d200-f242-11f0-b88d-c1c05263eee1",
                  "name": "Tanner Brown",
                  "position": "K",
                  "role": "kick"
                }
              ]
            }
          ]

Benefit

Use these new data points to quickly adapt your solution to this innovative rule change.

☑️ Sample Requests:

  • Game Play-by-Play - https://api.sportradar.com/ufl/trial/v7/en/games/{game_id}/pbp.json

🔢 Versions

🔁 Endpoints Affected

⚙️ Return Samples

Return Samples
{
          "type": "play",
          "id": "a5439360-1340-11f1-868d-3165bdf43f45",
          "sequence": 1772130397247,
          "clock": "14:12",
          "home_points": 4,
          "away_points": 3,
          "play_type": "field_goal",
          "scoring_play": true,
          "wall_clock": "2026-02-26T18:26:25+00:00",
          "description": "T.Brown 83 yard four-point field goal attempt is good, Center-LOU, Holder-LOU.",
          "scoring_description": "T.Brown 83 yard four-point field goal attempt is good, Center-LOU, Holder-LOU.",
          "fake_punt": false,
          "fake_field_goal": false,
          "screen_pass": false,
          "play_action": false,
          "run_pass_option": false,
          "created_at": "2026-02-26T18:26:37+00:00",
          "updated_at": "2026-02-26T18:26:37+00:00",
          "official": true,
          "start_situation": {
            "clock": "14:12",
            "down": 1,
            "yfd": 10,
            "possession": {
              "id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
              "name": "Kings",
              "market": "Louisville",
              "alias": "LOU"
            },
            "location": {
              "id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
              "name": "Kings",
              "market": "Louisville",
              "alias": "LOU",
              "yardline": 35
            }
          },
          "end_situation": {
            "clock": "14:02",
            "down": 0,
            "yfd": 0,
            "possession": {
              "id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
              "name": "Kings",
              "market": "Louisville",
              "alias": "LOU"
            },
            "location": {
              "id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
              "name": "Kings",
              "market": "Louisville",
              "alias": "LOU",
              "yardline": 30
            }
          },
          "score": {
            "sequence": 2,
            "clock": "14:02",
            "points": 4,
            "home_points": 4,
            "away_points": 3
          },
          "statistics": [
            {
              "stat_type": "field_goal",
              "attempt": 1,
              "att_yards": 83,
              "yards": 83,
              "missed": 0,
              "made": 1,
              "player": {
                "id": "9089d200-f242-11f0-b88d-c1c05263eee1",
                "name": "Tanner Brown",
                "position": "K"
              },
              "team": {
                "id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
                "name": "Kings",
                "market": "Louisville",
                "alias": "LOU"
              }
            }
          ],
          "details": [
            {
              "category": "field_goal_four_point",
              "description": "T.Brown 83 yard four-point field goal attempt is good, Center-LOU, Holder-LOU.",
              "sequence": 0,
              "yards": 83,
              "result": "good",
              "start_location": {
                "alias": "LOU",
                "yardline": 27
              },
              "end_location": {
                "alias": "LOU",
                "yardline": 27
              },
              "players": [
                {
                  "id": "9089d200-f242-11f0-b88d-c1c05263eee1",
                  "name": "Tanner Brown",
                  "position": "K",
                  "role": "kick"
                }
              ]
            }
          ]
        }
"field_goals": {
      "attempts": 20,
      "made": 13,
      "blocked": 3,
      "yards": 451,
      "avg_yards": 26.529,
      "longest": 50,
      "missed": 4,
      "pct": 65.0,
      "attempts_19": 0,
      "attempts_29": 6,
      "attempts_39": 5,
      "attempts_49": 5,
      "attempts_50": 4,
      "made_19": 0,
      "made_29": 5,
      "made_39": 4,
      "made_49": 2,
      "made_50": 2
      "made_50": 2,
      "attempts_60": 1,
      "made_60": 1
    },
{
            "name": "Matt McCrane",
            "jersey": "16",
            "id": "3fa286b0-cdd8-11ee-865e-6d293a2fea93",
            "position": "K",
            "attempts": 4,
            "made": 4,
            "blocked": 0,
            "yards": 150,
            "avg_yards": 37.5,
            "longest": 53,
            "att_yards": 150,
            "attempts_19": 0,
            "attempts_29": 1,
            "attempts_39": 2,
            "attempts_49": 0,
            "attempts_50": 1,
            "attempts_60": 1,
            "made_19": 0,
            "made_29": 1,
            "made_39": 2,
            "made_49": 0,
            "made_50": 1,
            "made_60": 1,
            "missed": 0,
            "net_attempts": 4,
            "pct": 100.0
          }


Player ID Linking

Release DateFeeds AffectedBenefit
07/22/2025

Player Profile

Team Profile

Team Roster

You can now reference a player’s NCAA profile within the UFL API !

When available, each player’s profile includes the corresponding ID from the NCAA Football API under player.reference(s), making it easier to connect college and pro profiles for analysis, draft prep, and career stats.

Return Samples
{
    "id": "11cad59d-90dd-449c-a839-dddaba4fe16c",
    "name": "Patrick Mahomes",
    "jersey": "15",
    "last_name": "Mahomes",
    "first_name": "Patrick",
    "abbr_name": "P.Mahomes",
    "birth_date": "1995-09-17",
    "weight": 225.0,
    "height": 74,
    "position": "QB",
    "birth_place": "Tyler, TX, USA",
    "high_school": "Whitehouse (TX)",
    "college": "Texas Tech",
    "college_conf": "Big Twelve Conference",
    "rookie_year": 2017,
    "status": "ACT",
    "sr_id": "sr:player:1129537",
    "experience": 9,
    "salary": 1255000,
    "team": {
        "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
        "name": "Chiefs",
        "market": "Kansas City",
        "alias": "KC",
        "sr_id": "sr:competitor:4422"
    },
    "draft": {
        "year": 2017,
        "round": 1,
        "number": 10,
        "team": {
            "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
            "name": "Chiefs",
            "market": "Kansas City",
            "alias": "KC",
            "sr_id": "sr:competitor:4422"
        }
    },
    "references": [
        {
            "source_id": "531fa6d3-9c8e-437b-8eca-8ca79bf12cc0",
            "scope": "NCAAFB",
            "id_type": "league_profile"
        }
    ],
    <players>
        <player id="0226b03b-f91d-4223-9813-9fcd2e9c3acc" name="Juwan Johnson" jersey="83" last_name="Johnson" first_name="Juwan" abbr_name="J.Johnson" birth_date="1996-09-13" weight="231.0" height="76" position="TE" birth_place="Glassboro, NJ, USA" high_school="Glassboro (NJ)" college="Oregon" college_conf="Pacific Twelve Conference" rookie_year="2020" status="ACT" sr_id="sr:player:2040489" experience="6" salary="1170000">
            <reference source_id="ac27c288-92a8-4e5a-839d-ccacfc017120" scope="NCAAFB" id_type="league_profile"/>
        </player>
        <player id="0560d134-d316-4cda-9d48-34d32267af68" name="Jack Stoll" jersey="88" last_name="Stoll" first_name="Jack" abbr_name="J.Stoll" birth_date="1998-01-28" weight="247.0" height="76" position="TE" birth_place="Lone Tree, CO, USA" high_school="Regis Jesuit (CO)" college="Nebraska" college_conf="Big Ten Conference" rookie_year="2021" status="ACT" sr_id="sr:player:2197596" experience="5" salary="1170000">
            <reference source_id="3df3b9b4-3ee8-4ad7-bf29-67ef11f81de4" scope="NCAAFB" id_type="league_profile"/>
        </player>
        <player id="07814d30-072a-11ef-ba75-176276cf11f0" name="Treyton Welch" jersey="82" last_name="Welch" first_name="Treyton" abbr_name="T.Welch" birth_date="2001-01-10" weight="240.0" height="76" position="TE" birth_place="Buffalo, MN, USA" high_school="Buffalo (MN)" college="Wyoming" college_conf="Mountain West Conference" rookie_year="2024" status="ACT" sr_id="sr:player:1855572" experience="1" salary="840000">
            <reference source_id="15e48a8f-805b-4ff0-b843-2c90bd1761e1" scope="NCAAFB" id_type="league_profile"/>
        </player>


Neutral Site Standings

Release DateFeeds AffectedBenefit
04/18/2025Postgame Standings

We've added team records for neutral site games in our football Postgame Standings endpoints. Find a team's seasonal neutral site record under record.category="neutral".

Historical info is available from 2021-present for NFL, UFL, USFL, and NCAA Football.

Return Samples
{
  "season": {
    "id": "26a6a4e0-dfc9-11ee-8f7c-27de425212d4",
    "year": 2024,
    "type": "PST",
    "name": "PST"
  },
  "conferences": [
    {
      "id": "1bdefe12-6cb2-4d6a-b208-b04602ae79c3",
      "name": "AFC",
      "alias": "AFC",
      "divisions": [
        {
          "id": "324decdd-aa1b-4074-8958-c009d8fac31a",
          "name": "AFC West",
          "alias": "AFC_WEST",
          "teams": [
            {
              "id": "1f6dcffb-9823-43cd-9ff4-e7a8466749b5",
              "name": "Chargers",
              "market": "Los Angeles",
              "alias": "LAC",
              "sr_id": "sr:competitor:4429",
              "rank": {
                "conference": 7,
                "division": 3
              },
              "streak": {
                "type": "loss",
                "length": 1,
                "desc": "Lost 1"
              },
              "strength_of_schedule": {
                "sos": 0.5,
                "wins": 1,
                "total": 2
              },
              "strength_of_victory": {
                "sov": 0,
                "wins": 0,
                "total": 0
              },
              "wins": 0,
              "losses": 1,
              "ties": 0,
              "win_pct": 0,
              "points_for": 12,
              "points_against": 32,
              "records": [
                {
                  "category": "home",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "afc",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 12,
                  "points_against": 32
                },
                {
                  "category": "nfc",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "division",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "road",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 12,
                  "points_against": 32
                },
                {
                  "category": "conference",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 12,
                  "points_against": 32
                }
              ]
            },
            {
              "id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
              "name": "Chiefs",
              "market": "Kansas City",
              "alias": "KC",
              "sr_id": "sr:competitor:4422",
              "rank": {
                "conference": 1,
                "division": 1
              },
              "streak": {
                "type": "loss",
                "length": 1,
                "desc": "Lost 1"
              },
              "strength_of_schedule": {
                "sos": 0.778,
                "wins": 7,
                "total": 9
              },
              "strength_of_victory": {
                "sov": 0.6,
                "wins": 3,
                "total": 5
              },
              "wins": 2,
              "losses": 1,
              "ties": 0,
              "win_pct": 0.667,
              "points_for": 77,
              "points_against": 83,
              "records": [
                {
                  "category": "division",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "conference",
                  "wins": 2,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 1,
                  "points_for": 55,
                  "points_against": 43
                },
                {
                  "category": "afc",
                  "wins": 2,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 1,
                  "points_for": 55,
                  "points_against": 43
                },
                {
                  "category": "home",
                  "wins": 2,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 1,
                  "points_for": 55,
                  "points_against": 43
                },
                {
                  "category": "road",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "nfc",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 22,
                  "points_against": 40
                },
                {
                  "category": "neutral",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 22,
                  "points_against": 40
                }
              ]
            },
            {
              "id": "ce92bd47-93d5-4fe9-ada4-0fc681e6caa0",
              "name": "Broncos",
              "market": "Denver",
              "alias": "DEN",
              "sr_id": "sr:competitor:4418",
              "rank": {
                "conference": 5,
                "division": 2
              },
              "streak": {
                "type": "loss",
                "length": 1,
                "desc": "Lost 1"
              },
              "strength_of_schedule": {
                "sos": 0.667,
                "wins": 2,
                "total": 3
              },
              "strength_of_victory": {
                "sov": 0,
                "wins": 0,
                "total": 0
              },
              "wins": 0,
              "losses": 1,
              "ties": 0,
              "win_pct": 0,
              "points_for": 7,
              "points_against": 31,
              "records": [
                {
                  "category": "afc",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 7,
                  "points_against": 31
                },
                {
                  "category": "home",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "nfc",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "division",
                  "wins": 0,
                  "losses": 0,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 0,
                  "points_against": 0
                },
                {
                  "category": "conference",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 7,
                  "points_against": 31
                },
                {
                  "category": "road",
                  "wins": 0,
                  "losses": 1,
                  "ties": 0,
                  "win_pct": 0,
                  "points_for": 7,
                  "points_against": 31
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "_comment": "Generation started @ 2025-04-18 13:32:55 UTC ended @ 2025-04-18 13:32:55 UTC"
}
<season
  xmlns="http://feed.elasticstats.com/schema/football/nfl/postgame-standings-v7.0.xsd" id="26a6a4e0-dfc9-11ee-8f7c-27de425212d4" year="2024" type="PST" name="PST">
  <conference id="1bdefe12-6cb2-4d6a-b208-b04602ae79c3" name="AFC" alias="AFC">
      <division id="324decdd-aa1b-4074-8958-c009d8fac31a" name="AFC West" alias="AFC_WEST">
          <team id="1f6dcffb-9823-43cd-9ff4-e7a8466749b5" name="Chargers" market="Los Angeles" alias="LAC" sr_id="sr:competitor:4429" wins="0" losses="1" ties="0" win_pct="0.0" points_for="12" points_against="32">
              <rank conference="7" division="3"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.5" wins="1" total="2"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="afc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="12" points_against="32"/>
                  <record category="nfc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="12" points_against="32"/>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="12" points_against="32"/>
              </records>
          </team>
          <team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422" wins="2" losses="1" ties="0" win_pct="0.667" points_for="77" points_against="83">
              <rank conference="1" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.778" wins="7" total="9"/>
              <strength-of-victory sov="0.6" wins="3" total="5"/>
              <records>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="conference" wins="2" losses="0" ties="0" win_pct="1.0" points_for="55" points_against="43"/>
                  <record category="afc" wins="2" losses="0" ties="0" win_pct="1.0" points_for="55" points_against="43"/>
                  <record category="home" wins="2" losses="0" ties="0" win_pct="1.0" points_for="55" points_against="43"/>
                  <record category="road" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="nfc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="22" points_against="40"/>
                  <record category="neutral" wins="0" losses="1" ties="0" win_pct="0.0" points_for="22" points_against="40"/>
              </records>
          </team>
          <team id="ce92bd47-93d5-4fe9-ada4-0fc681e6caa0" name="Broncos" market="Denver" alias="DEN" sr_id="sr:competitor:4418" wins="0" losses="1" ties="0" win_pct="0.0" points_for="7" points_against="31">
              <rank conference="5" division="2"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.667" wins="2" total="3"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="afc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="7" points_against="31"/>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="nfc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="7" points_against="31"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="7" points_against="31"/>
              </records>
          </team>
      </division>
      <division id="b95cd27d-d631-4fe1-bc05-0ae47fc0b14b" name="AFC East" alias="AFC_EAST">
          <team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376" wins="2" losses="1" ties="0" win_pct="0.667" points_for="87" points_against="64">
              <rank conference="2" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.5" wins="3" total="6"/>
              <strength-of-victory sov="0.333" wins="1" total="3"/>
              <records>
                  <record category="nfc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="home" wins="2" losses="0" ties="0" win_pct="1.0" points_for="58" points_against="32"/>
                  <record category="conference" wins="2" losses="1" ties="0" win_pct="0.667" points_for="87" points_against="64"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="29" points_against="32"/>
                  <record category="afc" wins="2" losses="1" ties="0" win_pct="0.667" points_for="87" points_against="64"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
              </records>
          </team>
      </division>
      <division id="e447e7c0-5997-4bb7-bea3-aaae48aedcb8" name="AFC South" alias="AFC_SOUTH">
          <team id="82d2d380-3834-4938-835f-aec541e5ece7" name="Texans" market="Houston" alias="HOU" sr_id="sr:competitor:4324" wins="1" losses="1" ties="0" win_pct="0.5" points_for="46" points_against="35">
              <rank conference="4" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.5" wins="2" total="4"/>
              <strength-of-victory sov="0.0" wins="0" total="1"/>
              <records>
                  <record category="conference" wins="1" losses="1" ties="0" win_pct="0.5" points_for="46" points_against="35"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="14" points_against="23"/>
                  <record category="nfc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="home" wins="1" losses="0" ties="0" win_pct="1.0" points_for="32" points_against="12"/>
                  <record category="afc" wins="1" losses="1" ties="0" win_pct="0.5" points_for="46" points_against="35"/>
              </records>
          </team>
      </division>
      <division id="eb60da78-4eb5-4184-971e-2c5cd4ab4988" name="AFC North" alias="AFC_NORTH">
          <team id="cb2f9f1f-ac67-424e-9e72-1475cb0ed398" name="Steelers" market="Pittsburgh" alias="PIT" sr_id="sr:competitor:4345" wins="0" losses="1" ties="0" win_pct="0.0" points_for="14" points_against="28">
              <rank conference="6" division="2"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.5" wins="1" total="2"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="14" points_against="28"/>
                  <record category="nfc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="afc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="14" points_against="28"/>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="14" points_against="28"/>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="0" losses="1" ties="0" win_pct="0.0" points_for="14" points_against="28"/>
              </records>
          </team>
          <team id="ebd87119-b331-4469-9ea6-d51fe3ce2f1c" name="Ravens" market="Baltimore" alias="BAL" sr_id="sr:competitor:4413" wins="1" losses="1" ties="0" win_pct="0.5" points_for="53" points_against="41">
              <rank conference="3" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.5" wins="2" total="4"/>
              <strength-of-victory sov="0.0" wins="0" total="1"/>
              <records>
                  <record category="nfc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="1" losses="0" ties="0" win_pct="1.0" points_for="28" points_against="14"/>
                  <record category="conference" wins="1" losses="1" ties="0" win_pct="0.5" points_for="53" points_against="41"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="25" points_against="27"/>
                  <record category="afc" wins="1" losses="1" ties="0" win_pct="0.5" points_for="53" points_against="41"/>
                  <record category="home" wins="1" losses="0" ties="0" win_pct="1.0" points_for="28" points_against="14"/>
              </records>
          </team>
      </division>
  </conference>
  <conference id="b1808e5f-d40b-47c0-8af8-5175c0fdcd26" name="NFC" alias="NFC">
      <division id="6dab3ca1-b9cb-403f-91dd-b2a3708ab060" name="NFC East" alias="NFC_EAST">
          <team id="22052ff7-c065-42ee-bc8f-c4691c50e624" name="Commanders" market="Washington" alias="WAS" sr_id="sr:competitor:4432" wins="2" losses="1" ties="0" win_pct="0.667" points_for="91" points_against="106">
              <rank conference="5" division="2"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.667" wins="4" total="6"/>
              <strength-of-victory sov="0.0" wins="0" total="2"/>
              <records>
                  <record category="division" wins="0" losses="1" ties="0" win_pct="0.0" points_for="23" points_against="55"/>
                  <record category="nfc" wins="2" losses="1" ties="0" win_pct="0.667" points_for="91" points_against="106"/>
                  <record category="afc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="road" wins="2" losses="1" ties="0" win_pct="0.667" points_for="91" points_against="106"/>
                  <record category="conference" wins="2" losses="1" ties="0" win_pct="0.667" points_for="91" points_against="106"/>
              </records>
          </team>
          <team id="386bdbf9-9eea-4869-bb9a-274b0bc66e80" name="Eagles" market="Philadelphia" alias="PHI" sr_id="sr:competitor:4428" wins="4" losses="0" ties="0" win_pct="1.0" points_for="145" points_against="77">
              <rank conference="1" division="1"/>
              <streak type="win" length="4" desc="Won 4"/>
              <strength-of-schedule sos="0.556" wins="5" total="9"/>
              <strength-of-victory sov="0.556" wins="5" total="9"/>
              <records>
                  <record category="road" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="conference" wins="3" losses="0" ties="0" win_pct="1.0" points_for="105" points_against="55"/>
                  <record category="afc" wins="1" losses="0" ties="0" win_pct="1.0" points_for="40" points_against="22"/>
                  <record category="neutral" wins="1" losses="0" ties="0" win_pct="1.0" points_for="40" points_against="22"/>
                  <record category="nfc" wins="3" losses="0" ties="0" win_pct="1.0" points_for="105" points_against="55"/>
                  <record category="home" wins="3" losses="0" ties="0" win_pct="1.0" points_for="105" points_against="55"/>
                  <record category="division" wins="1" losses="0" ties="0" win_pct="1.0" points_for="55" points_against="23"/>
              </records>
          </team>
      </division>
      <division id="390d000d-9949-42e6-bf5e-b166dc463675" name="NFC West" alias="NFC_WEST">
          <team id="2eff2a03-54d4-46ba-890e-2bc3925548f3" name="Rams" market="Los Angeles" alias="LA" sr_id="sr:competitor:4387" wins="1" losses="1" ties="0" win_pct="0.5" points_for="49" points_against="37">
              <rank conference="2" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.8" wins="4" total="5"/>
              <strength-of-victory sov="0.0" wins="0" total="1"/>
              <records>
                  <record category="afc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="neutral" wins="1" losses="0" ties="0" win_pct="1.0" points_for="27" points_against="9"/>
                  <record category="conference" wins="1" losses="1" ties="0" win_pct="0.5" points_for="49" points_against="37"/>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="nfc" wins="1" losses="1" ties="0" win_pct="0.5" points_for="49" points_against="37"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="22" points_against="28"/>
              </records>
          </team>
      </division>
      <division id="6dc1933f-ca90-46e6-aaf7-9b95cc44306a" name="NFC North" alias="NFC_NORTH">
          <team id="33405046-04ee-4058-a950-d606f8c30852" name="Vikings" market="Minnesota" alias="MIN" sr_id="sr:competitor:4423" wins="0" losses="1" ties="0" win_pct="0.0" points_for="9" points_against="27">
              <rank conference="7" division="3"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.5" wins="1" total="2"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="nfc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="9" points_against="27"/>
                  <record category="road" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="afc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="neutral" wins="0" losses="1" ties="0" win_pct="0.0" points_for="9" points_against="27"/>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="9" points_against="27"/>
              </records>
          </team>
          <team id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420" wins="0" losses="1" ties="0" win_pct="0.0" points_for="10" points_against="22">
              <rank conference="3" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="1.0" wins="4" total="4"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="10" points_against="22"/>
                  <record category="home" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="nfc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="10" points_against="22"/>
                  <record category="road" wins="0" losses="1" ties="0" win_pct="0.0" points_for="10" points_against="22"/>
                  <record category="afc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
              </records>
          </team>
          <team id="c5a59daa-53a7-4de0-851f-fb12be893e9e" name="Lions" market="Detroit" alias="DET" sr_id="sr:competitor:4419" wins="0" losses="1" ties="0" win_pct="0.0" points_for="31" points_against="45">
              <rank conference="6" division="2"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.667" wins="2" total="3"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="afc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="road" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="nfc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="31" points_against="45"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="home" wins="0" losses="1" ties="0" win_pct="0.0" points_for="31" points_against="45"/>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="31" points_against="45"/>
              </records>
          </team>
      </division>
      <division id="2a46bf95-b036-4c6c-b69f-a80c4b6c46bf" name="NFC South" alias="NFC_SOUTH">
          <team id="4254d319-1bc7-4f81-b4ab-b5e6f3402b69" name="Buccaneers" market="Tampa Bay" alias="TB" sr_id="sr:competitor:4388" wins="0" losses="1" ties="0" win_pct="0.0" points_for="20" points_against="23">
              <rank conference="4" division="1"/>
              <streak type="loss" length="1" desc="Lost 1"/>
              <strength-of-schedule sos="0.667" wins="2" total="3"/>
              <strength-of-victory sov="0.0" wins="0" total="0"/>
              <records>
                  <record category="afc" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="nfc" wins="0" losses="1" ties="0" win_pct="0.0" points_for="20" points_against="23"/>
                  <record category="home" wins="0" losses="1" ties="0" win_pct="0.0" points_for="20" points_against="23"/>
                  <record category="road" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
                  <record category="conference" wins="0" losses="1" ties="0" win_pct="0.0" points_for="20" points_against="23"/>
                  <record category="division" wins="0" losses="0" ties="0" win_pct="0.0" points_for="0" points_against="0"/>
              </records>
          </team>
      </division>
  </conference>
</season>


Support for Plays Under Review

Release DateFeeds AffectedBenefit
04/08/2025

Game Boxscore

Game Play-by-Play

Push Events

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.

Return Samples
{
   "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":[

         ]
      }
   ]
}
]
}


New On-Demand Simulations

Release DateBenefit
09/09/2024We’re happy to announce expanded on-demand support for REST and push Simulations . This offering allows you to replay select games at your convenience.
  • How it works*:
Request a list of available recordings by league.For a normal GET game feed:

  • Register a session for the game feed(s) you are interested in playing back.

  • Start your session on your schedule – no more waiting for simulated games to start at a predefined time.

  • Continually call the endpoint for updates as one would during a live game.
For the Push feeds, simply subscribe to the recording and watch the data come through like it would during a live game.

No API Key is needed to use the simulations.

Please note that Legacy Simulations will be retired in early November.

For more details, see our Simulations page including code snippets for how to set up your calls.


Source Games

Release DateFeeds AffectedBenefit
08/08/2024

Current Season Schedule

Current Week Schedule

Season Schedule

Weekly Schedule

We've added the source object from our new Tournament endpoints to the remaining Schedule endpoints.

Use the source field to access prior games in a tournament before the games have been played. Then use these games to create tournament brackets for league tournaments.

Return Samples
{
   "id":"3d8f5827-49b1-49b2-b2de-7087c54208fb",
   "status":"scheduled",
   "coverage":"full",
   "game_type":"regular",
   "scheduled":"2024-08-05T16:41:00+00:00",
   "entry_mode":"LDE",
   "conference_game":false,
   "home":{
      "name":"Semifinal 1 (win)",
      "alias":"Semifinal 1 (win)",
      "source":{
         "id":"7e8a2912-61f9-4142-8042-bb92e769ae84",
         "title":"Semifinal 1",
         "status":"closed",
         "coverage":"full",
         "game_type":"regular",
         "scheduled":"2024-07-30T17:29:00+00:00",
         "entry_mode":"LDE",
         "outcome":"win"
      }
   },
   "away":{
      "name":"Semifinal 2 (win)",
      "alias":"Semifinal 2 (win)",
      "source":{
         "id":"661af86f-33c7-4b57-9b17-3349c4a7caae",
         "title":"Semifinal 2",
         "status":"scheduled",
         "coverage":"full",
         "game_type":"regular",
         "scheduled":"2024-07-30T17:29:00+00:00",
         "entry_mode":"LDE",
         "outcome":"win"
      }
   },
   "timezone":{

   }
}


Tournament Endpoints

Release DateFeeds AffectedBenefit
08/01/2024

Tournament List

Tournament Schedule

Tournament Summary

We've added three new endpoints to allow you to more easily create tournament brackets.

The new endpoints mimic our existing College Basketball APIs. Parse them to create tournament brackets for the UFL playoffs and any other football league tournaments.

Tournament List - provides a summarized list of all tournaments scheduled for the given season

Tournament Schedule - provides the date, time, location, and other event details for every matchup taking place in a given tournament

Tournament Summary - provides tournament information including location, status, start date, end date, and participants



Parent IDs

Release DateFeeds AffectedBenefit
07/31/2024

Current Season Schedule

Current Week Schedule

Game Boxscore

Game Roster

Game Statistics

Play-by-Play

Season Schedule

Tournament Schedule

Weekly Schedule

Added a standard parent Id (parent_id) to games and tournaments.

Use this Id to group events (like the Super Bowl or Bowl games) across seasons.

Return Samples
<game xmlns="http://feed.elasticstats.com/schema/football/pbp-v7.0.xsd" id="ca9d8f84-8e7b-4ee7-a310-54c2e3ca4edc"
  status="scheduled" scheduled="2025-02-09T23:30:00+00:00" entry_mode="LDE" neutral_site="true"
  game_type="playoff" conference_game="false" title="Super Bowl LIX" parent_id="f6c2b12d-966c-41a5-98a7-054620fba38b">
{
    "id": "ca9d8f84-8e7b-4ee7-a310-54c2e3ca4edc",
    "status": "scheduled",
    "scheduled": "2025-02-09T23:30:00+00:00",
    "entry_mode": "LDE",
    "neutral_site": true,
    "game_type": "playoff",
    "conference_game": false,
    "title": "Super Bowl LIX",
    "parent_id": "f6c2b12d-966c-41a5-98a7-054620fba38b",
    "summary": {
        "season": {
            "id": "26a6a4e0-dfc9-11ee-8f7c-27de425212d4",
            "year": 2024,
            "type": "PST",
            "name": "PST"
        },
        "week": {
            "id": "e33d8a00-91d7-4cb5-b5f3-51cdaadd7089",
            "sequence": 4,
            "title": "4"
        },
        "venue": {
            "id": "3c85d89a-ec66-4983-acd5-1381d6c8673a",
            "name": "Caesars Superdome",
            "city": "New Orleans",
            "state": "LA",
            "country": "USA",
            "zip": "70112",
            "address": "1500 Sugar Bowl Drive",
            "capacity": 73208,
            "surface": "artificial",
            "roof_type": "dome",
            "sr_id": "sr:venue:8195",
            "location": {
                "lat": "29.950928",
                "lng": "-90.080876"
            }
        },
        "home": {
            "name": "NFC Championship (win)",
            "alias": "NFC Championship (win)"
        },
        "away": {
            "name": "AFC Championship (win)",
            "alias": "AFC Championship (win)"
        }
    },
    "broadcast": {
        "network": "FOX"
    },
    "periods": [],
    "_comment": "Generation started @ 2024-07-31 20:03:06 UTC ended @ 2024-07-31 20:03:06 UTC"
}


Broadcast Info & Time Zones

Release DateFeeds AffectedBenefit
07/11/2024

Current Season Schedule

Current Week Schedule

Game Boxscore

Game Roster

Game Statistics

Play-by-Play

Season Schedule

Weekly Schedule

We've added broadcast and time_zone info for all Season and Game endpoints.

Each game will include the following broadcast info (when applicable): Cable Channel, Internet Stream, Network, Radio Station, Satellite Station

Each game will include the following time zone info: Away team time zone, Home team time zone, Venue time zone

See below for sample data.

Return Samples
"time_zones": {
           "venue": "US/Pacific",
           "home": "US/Pacific",
           "away": "US/Central"
},
"broadcast": {
            "network": "CBS",
            "satellite": "ESPN Ocho",
            "internet": "ESPN+",
            "cable": "822",
            "radio": "Sirius 134, XM 231"
          },


📘

Earlier updates

Older updates are listed in the Change Log Archive.