Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Rosters and Players

This guide shows you how to query NFL endpoints for real-time transactions, rosters, injuries, player participation, and depth charts, and explains the difference between full rosters and team profiles.

Accessing Available Seasons (Prerequisite)

To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.

For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.

Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.


Introduction to Rosters

An NFL roster is the list of players associated with a team. You can access this data through three roster-specific endpoints:

  • Full Roster – The Team Roster endpoint provides the complete roster, including active players, inactive players, and practice squad members.
  • Active Roster – The Team Profile endpoint lists only the active players on a team.
  • Game Roster – The Game Roster endpoint shows the declared game roster, identifying which players from the full roster will be active for a specific game.
🏈

What is a practice squad?

The practice squad is a group of players who practice with the team but are not eligible to play in official games unless promoted to the active roster. This allows teams to develop players and have them readily available should they need replacements due to injury or other reasons during the season.


When Roster Data Is Updated

  • Seasonal Rosters and Depth Charts – Updated throughout the season by Sportradar.
  • Player Transactions – Monitored for all teams and players, updated as movement occurs.
  • Injuries – Rosters and injury reports are monitored daily for updates.
  • Draft Updates – Sportradar first introduced NFL Draft coverage ahead of the 2019 draft. See our NFL Draft Day integration scenario for more details.

For more on when roster, injury, and player participation data is added, see the NFL Data Entry Workflow.

🔄

Use the Update Frequencies Page

For recommended pull intervals and timing for each roster-related endpoint, see the Update Frequencies page to ensure you’re calling feeds at the optimal rate.



Accessing Roster Data


Team Rosters (Full and Active)

  • Full Roster – The Team Roster endpoint provides the complete roster, including active players, inactive players, and practice squad members.
  • Active Roster – The Team Profile endpoint lists only the active players on a team.
Team Roster Response Snippet
<team xmlns="http://feed.elasticstats.com/schema/football/team-v7.0.xsd" id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376" founded="1960" owner="Terry and Kim Pegula" general_manager="Brandon Beane" president="Terry Pegula" mascot="Billy Buffalo" fight_song="Shout" championships_won="0" conference_titles="4" division_titles="15" playoff_appearances="24">
  <franchise id="26f22bc6-1fb9-4c01-80cc-908342490651" name="Bills" alias="BUF"/>
  <venue id="e9e0828e-37fc-4238-a317-49037577dd55" name="Highmark Stadium" city="Orchard Park" state="NY" country="USA" zip="14127" address="One Bills Drive" capacity="71608" surface="artificial" roof_type="outdoor" sr_id="sr:venue:8171">
    <location lat="42.773826" lng="-78.786589"/>
  </venue>
  <hierarchy>
    <division id="b95cd27d-d631-4fe1-bc05-0ae47fc0b14b" name="AFC East" alias="AFC_EAST"/>
    <conference id="1bdefe12-6cb2-4d6a-b208-b04602ae79c3" name="AFC" alias="AFC"/>
  </hierarchy>
  <coaches>
    <coach id="0f0a2a50-bf99-11ee-b910-d944903b5e58" full_name="Bobby Babich" first_name="Bobby" last_name="Babich" position="Defensive Coordinator"/>
    <coach id="24ddc0fb-4e6f-4c67-b3c1-8fa7acd691cc" full_name="Sean McDermott" first_name="Sean" last_name="McDermott" position="Head Coach"/>
    <coach id="2546eccb-38e4-486d-9c69-c7d5215eaf34" full_name="Joe Brady" first_name="Joe" last_name="Brady" position="Offensive Coordinator"/>
    <coach id="604f91e0-8d33-11ee-8531-1fdfada41c55" full_name="Chris Tabor" first_name="Chris" last_name="Tabor" position="Special Teams Coordinator"/>
  </coaches>
  <players>
    <player id="007971f0-f012-11ed-833c-ebfbb713adc7" name="Richard Gouraige" jersey="75" last_name="Gouraige" first_name="Richard" abbr_name="R.Gouraige" birth_date="1998-10-15" weight="306.0" height="77" position="OT" birth_place="Tampa, FL, USA" high_school="Cambridge Christian School (FL)" college="Florida" college_conf="Southeastern Conference" rookie_year="2023" status="ACT" sr_id="sr:player:1413309" experience="1" salary="844000">
      <reference source_id="7ca5ce37-f566-44c4-9d66-158e1d903407" scope="NCAAFB" id_type="league_profile"/>
    </player>
    <player id="073d1bf8-7a0e-4c2f-b890-dbbd47978737" name="Michael Hoecht" jersey="55" last_name="Hoecht" first_name="Michael" abbr_name="M.Hoecht" birth_date="1997-10-05" weight="310.0" height="76" position="DE" birth_place="Oakwood, OH, USA" high_school="Oakwood (OH)" college="Brown" college_conf="Ivy League Conference" rookie_year="2020" status="ACT" sr_id="sr:player:1224198" experience="5" salary="4488000">
    </player>
    <player id="07eb12f0-f011-11ed-ac82-d7e41925e5ba" name="Tyrell Shavers" jersey="80" last_name="Shavers" first_name="Tyrell" abbr_name="T.Shavers" birth_date="1999-08-18" weight="211.0" height="76" position="WR" birth_place="Lewisville, TX, USA" high_school="Lewisville (TX)" college="San Diego State" college_conf="Mountain West Conference" rookie_year="2023" status="ACT" sr_id="sr:player:1235366" experience="1" salary="963500">
      <reference source_id="fccc4687-74e5-4f55-b5fa-e104fde6ea23" scope="NCAAFB" id_type="league_profile"/>
    </player>
    </team>
{
  "id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
  "name": "Bills",
  "market": "Buffalo",
  "alias": "BUF",
  "sr_id": "sr:competitor:4376",
  "founded": 1960,
  "owner": "Terry and Kim Pegula",
  "general_manager": "Brandon Beane",
  "president": "Terry Pegula",
  "mascot": "Billy Buffalo",
  "fight_song": "Shout",
  "championships_won": 0,
  "conference_titles": 4,
  "division_titles": 15,
  "playoff_appearances": 24,
  "franchise": {
    "id": "26f22bc6-1fb9-4c01-80cc-908342490651",
    "name": "Bills",
    "alias": "BUF"
  },
  "venue": {
    "id": "e9e0828e-37fc-4238-a317-49037577dd55",
    "name": "Highmark Stadium",
    "city": "Orchard Park",
    "state": "NY",
    "country": "USA",
    "zip": "14127",
    "address": "One Bills Drive",
    "capacity": 71608,
    "surface": "artificial",
    "roof_type": "outdoor",
    "sr_id": "sr:venue:8171",
    "location": {
      "lat": "42.773826",
      "lng": "-78.786589"
    }
  },
  "division": {
    "id": "b95cd27d-d631-4fe1-bc05-0ae47fc0b14b",
    "name": "AFC East",
    "alias": "AFC_EAST"
  },
  "conference": {
    "id": "1bdefe12-6cb2-4d6a-b208-b04602ae79c3",
    "name": "AFC",
    "alias": "AFC"
  },
  "coaches": [
    {
      "id": "0f0a2a50-bf99-11ee-b910-d944903b5e58",
      "full_name": "Bobby Babich",
      "first_name": "Bobby",
      "last_name": "Babich",
      "position": "Defensive Coordinator"
    },
    {
      "id": "24ddc0fb-4e6f-4c67-b3c1-8fa7acd691cc",
      "full_name": "Sean McDermott",
      "first_name": "Sean",
      "last_name": "McDermott",
      "position": "Head Coach"
    },
    {
      "id": "2546eccb-38e4-486d-9c69-c7d5215eaf34",
      "full_name": "Joe Brady",
      "first_name": "Joe",
      "last_name": "Brady",
      "position": "Offensive Coordinator"
    },
    {
      "id": "604f91e0-8d33-11ee-8531-1fdfada41c55",
      "full_name": "Chris Tabor",
      "first_name": "Chris",
      "last_name": "Tabor",
      "position": "Special Teams Coordinator"
    }
  ],
  "players": [
    {
      "id": "007971f0-f012-11ed-833c-ebfbb713adc7",
      "name": "Richard Gouraige",
      "jersey": "75",
      "last_name": "Gouraige",
      "first_name": "Richard",
      "abbr_name": "R.Gouraige",
      "birth_date": "1998-10-15",
      "weight": 306,
      "height": 77,
      "position": "OT",
      "birth_place": "Tampa, FL, USA",
      "high_school": "Cambridge Christian School (FL)",
      "college": "Florida",
      "college_conf": "Southeastern Conference",
      "rookie_year": 2023,
      "status": "ACT",
      "sr_id": "sr:player:1413309",
      "experience": 1,
      "salary": 844000,
      "references": [
        {
          "source_id": "7ca5ce37-f566-44c4-9d66-158e1d903407",
          "scope": "NCAAFB",
          "id_type": "league_profile"
        }
      ]
    },
    {
      "id": "073d1bf8-7a0e-4c2f-b890-dbbd47978737",
      "name": "Michael Hoecht",
      "jersey": "55",
      "last_name": "Hoecht",
      "first_name": "Michael",
      "abbr_name": "M.Hoecht",
      "birth_date": "1997-10-05",
      "weight": 310,
      "height": 76,
      "position": "DE",
      "birth_place": "Oakwood, OH, USA",
      "high_school": "Oakwood (OH)",
      "college": "Brown",
      "college_conf": "Ivy League Conference",
      "rookie_year": 2020,
      "status": "ACT",
      "sr_id": "sr:player:1224198",
      "experience": 5,
      "salary": 4488000
    },
    {
      "id": "07eb12f0-f011-11ed-ac82-d7e41925e5ba",
      "name": "Tyrell Shavers",
      "jersey": "80",
      "last_name": "Shavers",
      "first_name": "Tyrell",
      "abbr_name": "T.Shavers",
      "birth_date": "1999-08-18",
      "weight": 211,
      "height": 76,
      "position": "WR",
      "birth_place": "Lewisville, TX, USA",
      "high_school": "Lewisville (TX)",
      "college": "San Diego State",
      "college_conf": "Mountain West Conference",
      "rookie_year": 2023,
      "status": "ACT",
      "sr_id": "sr:player:1235366",
      "experience": 1,
      "salary": 963500,
      "references": [
        {
          "source_id": "fccc4687-74e5-4f55-b5fa-e104fde6ea23",
          "scope": "NCAAFB",
          "id_type": "league_profile"
        }
      ]
    },
    {
      "id": "089763ae-208d-4ad9-bb30-c97c0fcfdcd1",
      "name": "Dane Jackson",
      "jersey": "23",
      "last_name": "Jackson",
      "first_name": "Dane",
      "abbr_name": "D.Jackson",
      "birth_date": "1996-11-29",
      "weight": 180,
      "height": 71,
      "position": "CB",
      "birth_place": "Coraopolis, PA, USA",
      "high_school": "Cornell (PA)",
      "college": "Pittsburgh",
      "college_conf": "Atlantic Coast Conference",
      "rookie_year": 2020,
      "status": "ACT",
      "sr_id": "sr:player:2040145",
      "experience": 6,
      "salary": 1337500,
      "draft": {
        "year": 2020,
        "round": 7,
        "number": 239,
        "team": {
          "id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
          "name": "Bills",
          "market": "Buffalo",
          "alias": "BUF",
          "sr_id": "sr:competitor:4376"
        }
      },
      "references": [
        {
          "source_id": "5ee7656b-03f0-49ce-90ae-cb81ff072ee3",
          "scope": "NCAAFB",
          "id_type": "league_profile"
        }
      ]
    }
  ]
}

When you query the Team Roster endpoint, you’ll get detailed team-level information—like name, market, venue, ownership, and coaching staff—along with a complete list of players. Each player object includes identifiers, position, jersey number, physical attributes, birth details, college, rookie year, current status, experience, and salary. You can use these fields to display rosters, build player profiles, or integrate team and player data into your application.

Team Profile Response Snippet
<team xmlns="http://feed.elasticstats.com/schema/football/team-v7.0.xsd" id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376" founded="1960" owner="Terry and Kim Pegula" general_manager="Brandon Beane" president="Terry Pegula" mascot="Billy Buffalo" fight_song="Shout" championships_won="0" conference_titles="4" division_titles="15" playoff_appearances="24">
  <franchise id="26f22bc6-1fb9-4c01-80cc-908342490651" name="Bills" alias="BUF"/>
  <venue id="e9e0828e-37fc-4238-a317-49037577dd55" name="Highmark Stadium" city="Orchard Park" state="NY" country="USA" zip="14127" address="One Bills Drive" capacity="71608" surface="artificial" roof_type="outdoor" sr_id="sr:venue:8171">
    <location lat="42.773826" lng="-78.786589"/>
  </venue>
  <hierarchy>
    <division id="b95cd27d-d631-4fe1-bc05-0ae47fc0b14b" name="AFC East" alias="AFC_EAST"/>
    <conference id="1bdefe12-6cb2-4d6a-b208-b04602ae79c3" name="AFC" alias="AFC"/>
  </hierarchy>
  <coaches>
    <coach id="0f0a2a50-bf99-11ee-b910-d944903b5e58" full_name="Bobby Babich" first_name="Bobby" last_name="Babich" position="Defensive Coordinator"/>
    <coach id="24ddc0fb-4e6f-4c67-b3c1-8fa7acd691cc" full_name="Sean McDermott" first_name="Sean" last_name="McDermott" position="Head Coach"/>
    <coach id="2546eccb-38e4-486d-9c69-c7d5215eaf34" full_name="Joe Brady" first_name="Joe" last_name="Brady" position="Offensive Coordinator"/>
    <coach id="604f91e0-8d33-11ee-8531-1fdfada41c55" full_name="Chris Tabor" first_name="Chris" last_name="Tabor" position="Special Teams Coordinator"/>
  </coaches>
  <team_colors>
    <team_color type="secondary" hex_color="#c60c30" alpha="0.0">
      <rgb_color red="198" green="12" blue="48"/>
    </team_color>
    <team_color type="primary" hex_color="#00338d" alpha="0.0">
      <rgb_color red="0" green="51" blue="141"/>
    </team_color>
  </team_colors>
  <players>
    <player id="007971f0-f012-11ed-833c-ebfbb713adc7" name="Richard Gouraige" jersey="75" last_name="Gouraige" first_name="Richard" abbr_name="R.Gouraige" birth_date="1998-10-15" weight="306.0" height="77" position="OT" birth_place="Tampa, FL, USA" high_school="Cambridge Christian School (FL)" college="Florida" college_conf="Southeastern Conference" rookie_year="2023" status="ACT" sr_id="sr:player:1413309" experience="1" salary="844000">
      <reference source_id="7ca5ce37-f566-44c4-9d66-158e1d903407" scope="NCAAFB" id_type="league_profile"/>
    </player>
    <player id="073d1bf8-7a0e-4c2f-b890-dbbd47978737" name="Michael Hoecht" jersey="55" last_name="Hoecht" first_name="Michael" abbr_name="M.Hoecht" birth_date="1997-10-05" weight="310.0" height="76" position="DE" birth_place="Oakwood, OH, USA" high_school="Oakwood (OH)" college="Brown" college_conf="Ivy League Conference" rookie_year="2020" status="ACT" sr_id="sr:player:1224198" experience="5" salary="4488000">
    </player>
    <player id="07eb12f0-f011-11ed-ac82-d7e41925e5ba" name="Tyrell Shavers" jersey="80" last_name="Shavers" first_name="Tyrell" abbr_name="T.Shavers" birth_date="1999-08-18" weight="211.0" height="76" position="WR" birth_place="Lewisville, TX, USA" high_school="Lewisville (TX)" college="San Diego State" college_conf="Mountain West Conference" rookie_year="2023" status="ACT" sr_id="sr:player:1235366" experience="1" salary="963500">
      <reference source_id="fccc4687-74e5-4f55-b5fa-e104fde6ea23" scope="NCAAFB" id_type="league_profile"/>
    </player>
    </team>
{
  "id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
  "name": "Bills",
  "market": "Buffalo",
  "alias": "BUF",
  "sr_id": "sr:competitor:4376",
  "founded": 1960,
  "owner": "Terry and Kim Pegula",
  "general_manager": "Brandon Beane",
  "president": "Terry Pegula",
  "mascot": "Billy Buffalo",
  "fight_song": "Shout",
  "championships_won": 0,
  "conference_titles": 4,
  "division_titles": 15,
  "playoff_appearances": 24,
  "franchise": {
    "id": "26f22bc6-1fb9-4c01-80cc-908342490651",
    "name": "Bills",
    "alias": "BUF"
  },
  "venue": {
    "id": "e9e0828e-37fc-4238-a317-49037577dd55",
    "name": "Highmark Stadium",
    "city": "Orchard Park",
    "state": "NY",
    "country": "USA",
    "zip": "14127",
    "address": "One Bills Drive",
    "capacity": 71608,
    "surface": "artificial",
    "roof_type": "outdoor",
    "sr_id": "sr:venue:8171",
    "location": {
      "lat": "42.773826",
      "lng": "-78.786589"
    }
  },
  "division": {
    "id": "b95cd27d-d631-4fe1-bc05-0ae47fc0b14b",
    "name": "AFC East",
    "alias": "AFC_EAST"
  },
  "conference": {
    "id": "1bdefe12-6cb2-4d6a-b208-b04602ae79c3",
    "name": "AFC",
    "alias": "AFC"
  },
  "coaches": [
    {
      "id": "0f0a2a50-bf99-11ee-b910-d944903b5e58",
      "full_name": "Bobby Babich",
      "first_name": "Bobby",
      "last_name": "Babich",
      "position": "Defensive Coordinator"
    },
    {
      "id": "24ddc0fb-4e6f-4c67-b3c1-8fa7acd691cc",
      "full_name": "Sean McDermott",
      "first_name": "Sean",
      "last_name": "McDermott",
      "position": "Head Coach"
    },
    {
      "id": "2546eccb-38e4-486d-9c69-c7d5215eaf34",
      "full_name": "Joe Brady",
      "first_name": "Joe",
      "last_name": "Brady",
      "position": "Offensive Coordinator"
    },
    {
      "id": "604f91e0-8d33-11ee-8531-1fdfada41c55",
      "full_name": "Chris Tabor",
      "first_name": "Chris",
      "last_name": "Tabor",
      "position": "Special Teams Coordinator"
    }
  ],
  "team_colors": [
    {
      "type": "secondary",
      "hex_color": "#c60c30",
      "alpha": 0,
      "rgb_color": {
        "red": 198,
        "green": 12,
        "blue": 48
      }
    },
    {
      "type": "primary",
      "hex_color": "#00338d",
      "alpha": 0,
      "rgb_color": {
        "red": 0,
        "green": 51,
        "blue": 141
      }
    }
  ],
  "players": [
    {
      "id": "007971f0-f012-11ed-833c-ebfbb713adc7",
      "name": "Richard Gouraige",
      "jersey": "75",
      "last_name": "Gouraige",
      "first_name": "Richard",
      "abbr_name": "R.Gouraige",
      "birth_date": "1998-10-15",
      "weight": 306,
      "height": 77,
      "position": "OT",
      "birth_place": "Tampa, FL, USA",
      "high_school": "Cambridge Christian School (FL)",
      "college": "Florida",
      "college_conf": "Southeastern Conference",
      "rookie_year": 2023,
      "status": "ACT",
      "sr_id": "sr:player:1413309",
      "experience": 1,
      "salary": 844000,
      "references": [
        {
          "source_id": "7ca5ce37-f566-44c4-9d66-158e1d903407",
          "scope": "NCAAFB",
          "id_type": "league_profile"
        }
      ]
    },
    {
      "id": "073d1bf8-7a0e-4c2f-b890-dbbd47978737",
      "name": "Michael Hoecht",
      "jersey": "55",
      "last_name": "Hoecht",
      "first_name": "Michael",
      "abbr_name": "M.Hoecht",
      "birth_date": "1997-10-05",
      "weight": 310,
      "height": 76,
      "position": "DE",
      "birth_place": "Oakwood, OH, USA",
      "high_school": "Oakwood (OH)",
      "college": "Brown",
      "college_conf": "Ivy League Conference",
      "rookie_year": 2020,
      "status": "ACT",
      "sr_id": "sr:player:1224198",
      "experience": 5,
      "salary": 4488000
    },
    {
      "id": "07eb12f0-f011-11ed-ac82-d7e41925e5ba",
      "name": "Tyrell Shavers",
      "jersey": "80",
      "last_name": "Shavers",
      "first_name": "Tyrell",
      "abbr_name": "T.Shavers",
      "birth_date": "1999-08-18",
      "weight": 211,
      "height": 76,
      "position": "WR",
      "birth_place": "Lewisville, TX, USA",
      "high_school": "Lewisville (TX)",
      "college": "San Diego State",
      "college_conf": "Mountain West Conference",
      "rookie_year": 2023,
      "status": "ACT",
      "sr_id": "sr:player:1235366",
      "experience": 1,
      "salary": 963500,
      "references": [
        {
          "source_id": "fccc4687-74e5-4f55-b5fa-e104fde6ea23",
          "scope": "NCAAFB",
          "id_type": "league_profile"
        }
      ]
    }
  ]
}

When you query the Team Profile endpoint, you’ll receive team-level details such as name, market, venue, ownership, division, conference, coaching staff, and official team colors. The response also includes the active roster, listing only players currently active for the team, with each player’s identifiers, position, jersey number, physical attributes, birth details, college, rookie year, status, experience, and salary. Use this endpoint when you need current active player data along with rich team context.

💰

Leverage Team Franchise and Salary Data

You can also use the Team Roster and Team Profile endpoints to access detailed franchise data for NFL teams. This information includes the team's founding year, current owner, nicknames, records of championships and division titles won and more.

These feeds also include information on player salaries to help you analyze team payrolls, compare player earnings, and integrate financial insights into your app or platform. This can be valuable for sports analytics and salary cap management tools.

🎓

Link NFL and NCAAFB Player IDs

The reference array shows a player’s corresponding ID in another league’s API, such as mapping an NFL player to their NCAA record, so you can connect data across leagues.

Use the scope value to see which league a player ID came from.

The following is an example of how you can display a team roster on your platform, showcasing key details such as player names, jersey numbers, positions, age, height, weight, college, and birthplace.

📸

Accessing Headshots and Team Logos

To access team logos and player headshots, use the Images API.


Game Rosters

The Game Roster endpoint shows the declared game roster, identifying which players from the full roster will be active for a specific game.

Game Roster Response Snippet
<game xmlns="http://feed.elasticstats.com/schema/football/roster-v7.0.xsd" id="54b632a9-42c1-4e86-ba15-d3cd9be55e04" status="closed" scheduled="2024-10-04T00:15:00+00:00" attendance="70016" entry_mode="LDE" clock="8:45" quarter="5" sr_id="sr:match:50128345" game_type="regular" conference_game="true" title="Thursday Night Football" duration="3:16">
  <weather condition="Controlled Climate" humidity="0" temp="0">
    <wind speed="0"/>
  </weather>
  <summary>
    <season id="26a67dd0-dfc9-11ee-8f7c-27de425212d4" year="2024" type="REG" name="REG"/>
    <week id="2baaf47b-f95d-47bb-b8bf-233759a4cc79" sequence="5" title="5"/>
    <venue id="1f2d393b-2291-4835-a412-0714966ea245" name="Mercedes-Benz Stadium" city="Atlanta" state="GA" country="USA" zip="30313" address="441 Martin Luther King Jr Drive NW" capacity="71000" surface="artificial" roof_type="retractable_dome" sr_id="sr:venue:20343">
      <location lat="33.757368" lng="-84.401008"/>
    </venue>
    <home id="e6aa13a4-0055-48a9-bc41-be28dc106929" name="Falcons" market="Atlanta" alias="ATL" sr_id="sr:competitor:4393" used_timeouts="0" remaining_timeouts="2" points="36" used_challenges="0" remaining_challenges="2">
      <record wins="3" losses="2" ties="0"/>
    </home>
    <away id="4254d319-1bc7-4f81-b4ab-b5e6f3402b69" name="Buccaneers" market="Tampa Bay" alias="TB" sr_id="sr:competitor:4388" used_timeouts="0" remaining_timeouts="2" points="30" used_challenges="1" remaining_challenges="1">
      <record wins="3" losses="2" ties="0"/>
    </away>
  </summary>
  <time_zones venue="US/Eastern" home="US/Eastern" away="US/Eastern"/>
  <broadcast network="Amazon Prime Video"/>
  <home id="e6aa13a4-0055-48a9-bc41-be28dc106929" name="Falcons" market="Atlanta" alias="ATL" sr_id="sr:competitor:4393">
    <coach id="0ab3c520-bf70-11ee-9d33-df7a5bf46395" full_name="Jimmy Lake" first_name="Jimmy" last_name="Lake" position="Defensive Coordinator"/>
    <coach id="0396a63c-719f-412a-a49b-ac4fa431761c" full_name="Raheem Morris" first_name="Raheem" last_name="Morris" position="Head Coach"/>
    <coach id="ac19f240-bd7c-11ee-b933-33cc22f91ebd" full_name="Zac Robinson" first_name="Zac" last_name="Robinson" position="Offensive Coordinator"/>
    <player id="2df474e5-7117-4650-8d53-34b3fd0f1bbb" name="Justin Simmons" jersey="31" last_name="Simmons" first_name="Justin" abbr_name="J.Simmons" birth_date="1993-11-19" weight="202.0" height="74" position="SAF" age="30" birth_place="Manassas, VA, USA" high_school="Martin County (FL)" college="Boston College" college_conf="Atlantic Coast Conference" rookie_year="2016" status="started" sr_id="sr:player:987677" in_game_status="active">
      <draft year="2016" round="3" number="98">
        <team id="ce92bd47-93d5-4fe9-ada4-0fc681e6caa0" name="Broncos" market="Denver" alias="DEN" sr_id="sr:competitor:4418"/>
      </draft>
    </player>
    <player id="d2710837-baa1-46e3-94c8-7dffe08c93bb" name="Drew Dalman" jersey="67" last_name="Dalman" first_name="Drew" abbr_name="D.Dalman" birth_date="1998-10-15" weight="305.0" height="75" position="OL" age="25" birth_place="Salinas, CA, USA" high_school="Palma (CA)" college="Stanford" college_conf="Pacific Twelve Conference" rookie_year="2021" status="dnp" sr_id="sr:player:2198632" in_game_status="active">
      <draft year="2021" round="4" number="114">
        <team id="e6aa13a4-0055-48a9-bc41-be28dc106929" name="Falcons" market="Atlanta" alias="ATL" sr_id="sr:competitor:4393"/>
      </draft>
    </player>
    <player id="47e64968-acea-454d-a95f-107a90960aab" name="Brandon Parker" jersey="75" last_name="Parker" first_name="Brandon" abbr_name="B.Parker" birth_date="1995-10-21" weight="305.0" height="79" position="OT" age="28" birth_place="Kannapolis, NC, USA" high_school="A.L. Brown (NC)" college="North Carolina A&amp;T" college_conf="Mid-Eastern Athletic Conference" rookie_year="2018" status="deactivated" sr_id="sr:player:1195870" in_game_status="active">
      <draft year="2018" round="3" number="65">
        <team id="7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576" name="Raiders" market="Las Vegas" alias="LV" sr_id="sr:competitor:4390"/>
      </draft>
      </game>
{
  "id": "54b632a9-42c1-4e86-ba15-d3cd9be55e04",
  "status": "closed",
  "scheduled": "2024-10-04T00:15:00+00:00",
  "attendance": 70016,
  "entry_mode": "LDE",
  "clock": "8:45",
  "quarter": 5,
  "sr_id": "sr:match:50128345",
  "game_type": "regular",
  "conference_game": true,
  "title": "Thursday Night Football",
  "duration": "3:16",
  "weather": {
    "condition": "Controlled Climate",
    "humidity": 0,
    "temp": 0,
    "wind": {
      "speed": 0
    }
  },
  "summary": {
    "season": {
      "id": "26a67dd0-dfc9-11ee-8f7c-27de425212d4",
      "year": 2024,
      "type": "REG",
      "name": "REG"
    },
    "week": {
      "id": "2baaf47b-f95d-47bb-b8bf-233759a4cc79",
      "sequence": 5,
      "title": "5"
    },
    "venue": {
      "id": "1f2d393b-2291-4835-a412-0714966ea245",
      "name": "Mercedes-Benz Stadium",
      "city": "Atlanta",
      "state": "GA",
      "country": "USA",
      "zip": "30313",
      "address": "441 Martin Luther King Jr Drive NW",
      "capacity": 71000,
      "surface": "artificial",
      "roof_type": "retractable_dome",
      "sr_id": "sr:venue:20343",
      "location": {
        "lat": "33.757368",
        "lng": "-84.401008"
      }
    },
    "home": {
      "id": "e6aa13a4-0055-48a9-bc41-be28dc106929",
      "name": "Falcons",
      "market": "Atlanta",
      "alias": "ATL",
      "sr_id": "sr:competitor:4393",
      "used_timeouts": 0,
      "remaining_timeouts": 2,
      "points": 36,
      "used_challenges": 0,
      "remaining_challenges": 2,
      "record": {
        "wins": 3,
        "losses": 2,
        "ties": 0
      }
    },
    "away": {
      "id": "4254d319-1bc7-4f81-b4ab-b5e6f3402b69",
      "name": "Buccaneers",
      "market": "Tampa Bay",
      "alias": "TB",
      "sr_id": "sr:competitor:4388",
      "used_timeouts": 0,
      "remaining_timeouts": 2,
      "points": 30,
      "used_challenges": 1,
      "remaining_challenges": 1,
      "record": {
        "wins": 3,
        "losses": 2,
        "ties": 0
      }
    }
  },
  "time_zones": {
    "venue": "US/Eastern",
    "home": "US/Eastern",
    "away": "US/Eastern"
  },
  "broadcast": {
    "network": "Amazon Prime Video"
  },
  "home": {
    "id": "e6aa13a4-0055-48a9-bc41-be28dc106929",
    "name": "Falcons",
    "market": "Atlanta",
    "alias": "ATL",
    "sr_id": "sr:competitor:4393",
    "coaches": [
      {
        "id": "0ab3c520-bf70-11ee-9d33-df7a5bf46395",
        "full_name": "Jimmy Lake",
        "first_name": "Jimmy",
        "last_name": "Lake",
        "position": "Defensive Coordinator"
      },
      {
        "id": "0396a63c-719f-412a-a49b-ac4fa431761c",
        "full_name": "Raheem Morris",
        "first_name": "Raheem",
        "last_name": "Morris",
        "position": "Head Coach"
      },
      {
        "id": "ac19f240-bd7c-11ee-b933-33cc22f91ebd",
        "full_name": "Zac Robinson",
        "first_name": "Zac",
        "last_name": "Robinson",
        "position": "Offensive Coordinator"
      }
    ],
    "players": [
      {
        "id": "2df474e5-7117-4650-8d53-34b3fd0f1bbb",
        "name": "Justin Simmons",
        "jersey": "31",
        "last_name": "Simmons",
        "first_name": "Justin",
        "abbr_name": "J.Simmons",
        "birth_date": "1993-11-19",
        "weight": 202,
        "height": 74,
        "position": "SAF",
        "age": 30,
        "birth_place": "Manassas, VA, USA",
        "high_school": "Martin County (FL)",
        "college": "Boston College",
        "college_conf": "Atlantic Coast Conference",
        "rookie_year": 2016,
        "status": "started",
        "sr_id": "sr:player:987677",
        "in_game_status": "active",
        "draft": {
          "year": 2016,
          "round": 3,
          "number": 98,
          "team": {
            "id": "ce92bd47-93d5-4fe9-ada4-0fc681e6caa0",
            "name": "Broncos",
            "market": "Denver",
            "alias": "DEN",
            "sr_id": "sr:competitor:4418"
          }
        }
      },
      {
        "id": "d2710837-baa1-46e3-94c8-7dffe08c93bb",
        "name": "Drew Dalman",
        "jersey": "67",
        "last_name": "Dalman",
        "first_name": "Drew",
        "abbr_name": "D.Dalman",
        "birth_date": "1998-10-15",
        "weight": 305,
        "height": 75,
        "position": "OL",
        "age": 25,
        "birth_place": "Salinas, CA, USA",
        "high_school": "Palma (CA)",
        "college": "Stanford",
        "college_conf": "Pacific Twelve Conference",
        "rookie_year": 2021,
        "status": "dnp",
        "sr_id": "sr:player:2198632",
        "in_game_status": "active",
        "draft": {
          "year": 2021,
          "round": 4,
          "number": 114,
          "team": {
            "id": "e6aa13a4-0055-48a9-bc41-be28dc106929",
            "name": "Falcons",
            "market": "Atlanta",
            "alias": "ATL",
            "sr_id": "sr:competitor:4393"
          }
        }
      },
      {
        "id": "47e64968-acea-454d-a95f-107a90960aab",
        "name": "Brandon Parker",
        "jersey": "75",
        "last_name": "Parker",
        "first_name": "Brandon",
        "abbr_name": "B.Parker",
        "birth_date": "1995-10-21",
        "weight": 305,
        "height": 79,
        "position": "OT",
        "age": 28,
        "birth_place": "Kannapolis, NC, USA",
        "high_school": "A.L. Brown (NC)",
        "college": "North Carolina A&T",
        "college_conf": "Mid-Eastern Athletic Conference",
        "rookie_year": 2018,
        "status": "deactivated",
        "sr_id": "sr:player:1195870",
        "in_game_status": "active",
        "draft": {
          "year": 2018,
          "round": 3,
          "number": 65,
          "team": {
            "id": "7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576",
            "name": "Raiders",
            "market": "Las Vegas",
            "alias": "LV",
            "sr_id": "sr:competitor:4390"
          }
        }
      }
    ]
  }
}

When you query the Game Roster endpoint, you’ll get game-specific roster data for both teams, including only the players eligible for that matchup. The response includes game metadata (status, schedule, venue, attendance, weather, broadcast network) and team details (name, market, coaches). Each player object contains identifiers, position, jersey number, physical attributes, birth details, college, rookie year, draft information, and real-time fields like status and in_game_status so you can track availability (started, dnp, deactivated, etc.) and participation during the game. Use this feed to build live roster views, injury updates, or player tracking features tied to a specific event.

🏈

Player Participation and In-Game Player Status

  • The status refers to the overall game status of a player, indicating whether they were deactivated, did not play (dnp), played, or started in the game.
  • The in_game_status indicates the real-time condition of a player during the game, such as whether they are active, probable, questionable, doubtful, out, benched, or unknown.
👍

Leveraging In-Game Player Statuses

You can use the Game Roster feed to track in-game player status updates with the in_game_status datapoint. This status updates in real-time to show whether players are active, probable, questionable, doubtful, benched, out, or unknown during the game.

For more on tracking live game and play-by-play data, see the **Live Game Updates **integration scenario.



Player Profile Data

Use the Player Profile endpoint to go beyond roster data, accessing detailed player information including biographical data, salary, draft history, and seasonal statistics.

Player Profile Data Response Snippet
<player xmlns="http://feed.elasticstats.com/schema/football/profile-v7.0.xsd" id="3069db07-aa43-4503-ab11-2ae5c0002721" name="Josh Allen" jersey="17" last_name="Allen" first_name="Josh" abbr_name="J.Allen" birth_date="1996-05-21" weight="237.0" height="77" position="QB" birth_place="Firebaugh, CA, USA" high_school="Firebaugh (CA)" college="Wyoming" college_conf="Mountain West Conference" rookie_year="2018" status="ACT" sr_id="sr:player:1208608" experience="8" salary="36335281">
  <team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376"/>
  <draft year="2018" round="1" number="7">
    <team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376"/>
  </draft>
  <reference source_id="8d8ecf36-6983-47ab-89ec-7ecf328bbc63" scope="NCAAFB" id_type="league_profile"/>
  <season id="215f6286-3e05-476d-abe1-b2b0f5dfdff8" year="2018" type="PRE" name="PRE">
    <team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376">
      <statistics games_played="3" games_started="1">
        <rushing avg_yards="7.143" attempts="7" touchdowns="0" yards="50" longest="13" longest_touchdown="0" redzone_attempts="0" tlost="0" tlost_yards="0" first_downs="0" broken_tackles="0" kneel_downs="0" scrambles="0" yards_after_contact="0"/>
        <passing attempts="44" completions="24" cmp_pct="54.545" yards="210" avg_yards="4.773" sacks="7" sack_yards="51" touchdowns="2" longest="27" interceptions="0" rating="82.6" longest_touchdown="14" air_yards="125" redzone_attempts="4" gross_yards="210" first_downs="0" throw_aways="0" poor_throws="0" defended_passes="0" dropped_passes="0" spikes="0" blitzes="0" hurries="0" knockdowns="0" pocket_time="0.0" avg_pocket_time="0.0" net_yards="159" batted_passes="0" on_target_throws="0"/>
        <conversions pass_attempts="1" pass_successes="0" rush_attempts="0" rush_successes="0" receive_attempts="0" receive_successes="0" defense_attempts="0" defense_successes="0"/>
      </statistics>
    </team>
{
  "id": "3069db07-aa43-4503-ab11-2ae5c0002721",
  "name": "Josh Allen",
  "jersey": "17",
  "last_name": "Allen",
  "first_name": "Josh",
  "abbr_name": "J.Allen",
  "birth_date": "1996-05-21",
  "weight": 237,
  "height": 77,
  "position": "QB",
  "birth_place": "Firebaugh, CA, USA",
  "high_school": "Firebaugh (CA)",
  "college": "Wyoming",
  "college_conf": "Mountain West Conference",
  "rookie_year": 2018,
  "status": "ACT",
  "sr_id": "sr:player:1208608",
  "experience": 8,
  "salary": 36335281,
  "team": {
    "id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
    "name": "Bills",
    "market": "Buffalo",
    "alias": "BUF",
    "sr_id": "sr:competitor:4376"
  },
  "draft": {
    "year": 2018,
    "round": 1,
    "number": 7,
    "team": {
      "id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
      "name": "Bills",
      "market": "Buffalo",
      "alias": "BUF",
      "sr_id": "sr:competitor:4376"
    }
  },
  "references": [
    {
      "source_id": "8d8ecf36-6983-47ab-89ec-7ecf328bbc63",
      "scope": "NCAAFB",
      "id_type": "league_profile"
    }
  ],
  "seasons": [
    {
      "id": "215f6286-3e05-476d-abe1-b2b0f5dfdff8",
      "year": 2018,
      "type": "PRE",
      "name": "PRE",
      "teams": [
        {
          "id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
          "name": "Bills",
          "market": "Buffalo",
          "alias": "BUF",
          "sr_id": "sr:competitor:4376",
          "statistics": {
            "games_played": 3,
            "games_started": 1,
            "rushing": {
              "avg_yards": 7.143,
              "attempts": 7,
              "touchdowns": 0,
              "yards": 50,
              "longest": 13,
              "longest_touchdown": 0,
              "redzone_attempts": 0,
              "tlost": 0,
              "tlost_yards": 0,
              "first_downs": 0,
              "broken_tackles": 0,
              "kneel_downs": 0,
              "scrambles": 0,
              "yards_after_contact": 0
            },
            "passing": {
              "attempts": 44,
              "completions": 24,
              "cmp_pct": 54.545,
              "yards": 210,
              "avg_yards": 4.773,
              "sacks": 7,
              "sack_yards": 51,
              "touchdowns": 2,
              "longest": 27,
              "interceptions": 0,
              "rating": 82.6,
              "longest_touchdown": 14,
              "air_yards": 125,
              "redzone_attempts": 4,
              "gross_yards": 210,
              "first_downs": 0,
              "throw_aways": 0,
              "poor_throws": 0,
              "defended_passes": 0,
              "dropped_passes": 0,
              "spikes": 0,
              "blitzes": 0,
              "hurries": 0,
              "knockdowns": 0,
              "pocket_time": 0,
              "avg_pocket_time": 0,
              "net_yards": 159,
              "batted_passes": 0,
              "on_target_throws": 0
            },
            "conversions": {
              "pass_attempts": 1,
              "pass_successes": 0,
              "rush_attempts": 0,
              "rush_successes": 0,
              "receive_attempts": 0,
              "receive_successes": 0,
              "defense_attempts": 0,
              "defense_successes": 0
            }
          }
        }
      ]
    }
  ]
}

When you query the Player Profile endpoint, you’ll get a complete record for a specific player, including biographical details (name, birth date, height, weight, hometown, high school, and college), position, rookie year, current status, experience, and salary. The response includes the player’s current team, draft information, and linked league references (e.g., NCAA profile IDs). You’ll also receive season-by-season statistics, broken down by category such as passing, rushing, and conversions, along with game counts and situational metrics. Use this endpoint when you need a player’s full background, contract details, and statistical history in one place.

The following is an example of how you can display player profile data on your platform, showcasing key details such as seasonal stat summaries, positions, and biographical details such as age, college, and birthplace.



Injury Data

You can access injury data using the Weekly Injuries feed. This endpoint provides a list of injured players for each team for a given week, including practice status.

Weekly Injuries Response Snippet
<season xmlns="http://feed.elasticstats.com/schema/football/injuries-v7.0.xsd" id="a538d200-e916-4272-aa07-b486094a1668" year="2023" type="REG" name="REG">
  <week id="9d81d807-ef3c-4335-94c4-981b376df6bc" sequence="10" title="10"/>
  <injuries>
    <team id="4254d319-1bc7-4f81-b4ab-b5e6f3402b69" name="Buccaneers" market="Tampa Bay" alias="TB" sr_id="sr:competitor:4388">
      <player id="ec558188-4bc5-4e5a-9035-dca1b46a49d4" name="Logan Hall" jersey="90" position="DL" sr_id="sr:player:1500975">
        <injury status="Questionable" status_date="2023-11-10T00:00:00+00:00">
          <practice status="Full Participation In Practice"/>
          <primary>Groin</primary>
        </injury>
      </player>
      <player id="95242131-623b-41d0-8898-9d6f71da56f7" name="Josh Hayes" jersey="32" position="DB" sr_id="sr:player:1249510">
        <injury status="Out" status_date="2023-11-10T00:00:00+00:00">
          <practice status="Did Not Participate In Practice"/>
          <primary>Concussion</primary>
        </injury>
      </player>
      <player id="9a011241-f4b3-403a-af70-c9cdfd177054" name="Trey Palmer" jersey="10" position="WR" sr_id="sr:player:1694071">
        <injury status="Questionable" status_date="2023-11-10T00:00:00+00:00">
          <practice status="Full Participation In Practice"/>
          <primary>Neck</primary>
        </injury>
      </player>
      <player id="4c6f79d0-d3dd-11ec-8afa-57d9afd0ecba" name="Deven Thompkins" jersey="83" position="WR" sr_id="sr:player:1478034">
        <injury status_date="2023-11-10T00:00:00+00:00">
          <practice status="Full Participation In Practice"/>
          <primary>Personal</primary>
        </injury>
      </player>
      <player id="503eb9a7-83ed-4b96-b0f2-7afe4920bde9" name="Vita Vea" jersey="50" position="DL" sr_id="sr:player:1226254">
        <injury status_date="2023-11-10T00:00:00+00:00">
          <practice status="Full Participation In Practice"/>
          <primary>Groin</primary>
        </injury>
      </player>
      </season>
{
  "season": {
    "id": "a538d200-e916-4272-aa07-b486094a1668",
    "year": 2023,
    "type": "REG",
    "name": "REG"
  },
  "week": {
    "id": "9d81d807-ef3c-4335-94c4-981b376df6bc",
    "sequence": 10,
    "title": "10"
  },
  "teams": [
    {
      "id": "4254d319-1bc7-4f81-b4ab-b5e6f3402b69",
      "name": "Buccaneers",
      "market": "Tampa Bay",
      "alias": "TB",
      "sr_id": "sr:competitor:4388",
      "players": [
        {
          "id": "ec558188-4bc5-4e5a-9035-dca1b46a49d4",
          "name": "Logan Hall",
          "jersey": "90",
          "position": "DL",
          "sr_id": "sr:player:1500975",
          "injuries": [
            {
              "status": "Questionable",
              "status_date": "2023-11-10T00:00:00+00:00",
              "practice": {
                "status": "Full Participation In Practice"
              },
              "primary": "Groin"
            }
          ]
        },
        {
          "id": "95242131-623b-41d0-8898-9d6f71da56f7",
          "name": "Josh Hayes",
          "jersey": "32",
          "position": "DB",
          "sr_id": "sr:player:1249510",
          "injuries": [
            {
              "status": "Out",
              "status_date": "2023-11-10T00:00:00+00:00",
              "practice": {
                "status": "Did Not Participate In Practice"
              },
              "primary": "Concussion"
            }
          ]
        },
        {
          "id": "9a011241-f4b3-403a-af70-c9cdfd177054",
          "name": "Trey Palmer",
          "jersey": "10",
          "position": "WR",
          "sr_id": "sr:player:1694071",
          "injuries": [
            {
              "status": "Questionable",
              "status_date": "2023-11-10T00:00:00+00:00",
              "practice": {
                "status": "Full Participation In Practice"
              },
              "primary": "Neck"
            }
          ]
        },
        {
          "id": "4c6f79d0-d3dd-11ec-8afa-57d9afd0ecba",
          "name": "Deven Thompkins",
          "jersey": "83",
          "position": "WR",
          "sr_id": "sr:player:1478034",
          "injuries": [
            {
              "status_date": "2023-11-10T00:00:00+00:00",
              "practice": {
                "status": "Full Participation In Practice"
              },
              "primary": "Personal"
            }
          ]
        },
        {
          "id": "503eb9a7-83ed-4b96-b0f2-7afe4920bde9",
          "name": "Vita Vea",
          "jersey": "50",
          "position": "DL",
          "sr_id": "sr:player:1226254",
          "injuries": [
            {
              "status_date": "2023-11-10T00:00:00+00:00",
              "practice": {
                "status": "Full Participation In Practice"
              },
              "primary": "Groin"
            }
          ]
        },

When you query the Weekly Injuries feed, you’ll get injury reports for all teams in a given week of the season. The response includes season and week details, then lists each team with its affected players. For each player, you’ll see identifiers, position, jersey number, and an array of injury records. Each injury entry contains the player’s game status (Out, Questionable, etc.), the date the status was recorded, practice participation level, and the primary injury type. Use this feed to track injury trends, update fantasy or betting applications, or display up-to-date player availability for the week.

The following image is an example of how you can visualize injury data on your platform.



Depth Charts

NFL depth charts illustrate players on a team in order of their position and playing status. They show the starters and the backup players for each position, indicating who would step in during a game if a starter were unavailable due to injury or other reasons.

You can access depth chart data using the Weekly Depth Charts feed. This endpoint provides depth chart information for each team for a given week.

Weekly Depth Charts Response Snippet
{
  "season": {
    "id": "a538d200-e916-4272-aa07-b486094a1668",
    "year": 2023,
    "type": "REG",
    "name": "REG"
  },
  "week": {
    "id": "b97007d7-03b1-4ef9-8fb1-d96d7abdb722",
    "sequence": 1,
    "title": "1"
  },
  "teams": [
    {
      "id": "de760528-1dc0-416a-a978-b510d20692ff",
      "name": "Cardinals",
      "market": "Arizona",
      "alias": "ARI",
      "sr_id": "sr:competitor:4412",
      "offense": [
        {
          "position": {
            "name": "TE",
            "players": [
              {
                "id": "de3421f7-2147-4835-89a5-724e87bad463",
                "name": "Zach Ertz",
                "jersey": "86",
                "position": "TE",
                "sr_id": "sr:player:827633",
                "depth": 1
              },
              {
                "id": "734d54cc-c869-4e2f-a60f-c59c493f5110",
                "name": "Trey McBride",
                "jersey": "85",
                "position": "TE",
                "sr_id": "sr:player:1473622",
                "depth": 2
              },
              {
                "id": "d0f9112d-2496-450a-9fc5-d2d01b4d2454",
                "name": "Geoff Swaim",
                "jersey": "87",
                "position": "TE",
                "sr_id": "sr:player:855676",
                "depth": 3
              },
              {
                "id": "a01b7698-d67f-4b60-b2fb-4c667336b718",
                "name": "Elijah Higgins",
                "jersey": "84",
                "position": "TE",
                "sr_id": "sr:player:1696253",
                "depth": 4
              }
            ]
          }
        },
        {
          "position": {
            "name": "LG",
            "players": [
              {
                "id": "00fdaebe-c8f6-43fa-addb-6a57dc6c5969",
                "name": "Elijah Wilkinson",
                "jersey": "65",
                "position": "OL",
                "sr_id": "sr:player:1137927",
                "depth": 1
              },
              {
                "id": "f1f4a350-cc5f-43a2-bde1-829058d6c338",
                "name": "Carter O'Donnell",
                "jersey": "61",
                "position": "OL",
                "sr_id": "sr:player:2040355",
                "depth": 2
              }
            ]
          }
        },
        {
          "position": {
            "name": "RG",
            "players": [
              {
                "id": "3a39ab56-f188-4924-862d-c79ce67a3420",
                "name": "Will Hernandez",
                "jersey": "76",
                "position": "OL",
                "sr_id": "sr:player:1188454",
                "depth": 1
              },
              {
                "id": "a3f67680-66f1-4efc-b21b-badd19467cc9",
                "name": "Trystan Colon",
                "jersey": "63",
                "position": "OL",
                "sr_id": "sr:player:1220306",
                "depth": 2
              }
            ]
          }
        },
        {
          "position": {
            "name": " WR",
            "players": [
              {
                "id": "7fc949b6-a1cb-4f9d-a06d-b65773409a44",
                "name": "Zach Pascal",
                "jersey": "0",
                "position": "WR",
                "sr_id": "sr:player:1132243",
                "depth": 1
              },
              {
                "id": "b91be982-fccd-448e-869b-e9b5148a1730",
                "name": "Michael Wilson",
                "jersey": "14",
                "position": "WR",
                "sr_id": "sr:player:1438988",
                "depth": 2
              }
            ]
          }
        },
        {
          "position": {
            "name": "RT",
            "players": [
              {
                "id": "b46d84ef-d811-47f5-a6e2-586bfbc8f548",
                "name": "Paris Johnson Jr.",
                "jersey": "70",
                "position": "OL",
                "sr_id": "sr:player:2001137",
                "depth": 1
              },
              {
                "id": "d96246d7-aa2c-4d05-9c58-8d6bc5e20cdf",
                "name": "Kelvin Beachum",
                "jersey": "68",
                "position": "OL",
                "sr_id": "sr:player:829037",
                "depth": 2
              }
            ]
          }
        },
        {
          "position": {
            "name": "LT",
            "players": [
              {
                "id": "90d9c6b2-3970-45e1-a558-b68a977a8995",
                "name": "D.J. Humphries",
                "position": "OL",
                "sr_id": "sr:player:834537",
                "depth": 1
              },
              {
                "id": "2f58f750-e8f3-11ed-bb4e-979e408fed0c",
                "name": "Ilm Manning",
                "jersey": "73",
                "position": "OL",
                "sr_id": "sr:player:1477174",
                "depth": 2
              },
              {
                "id": "adb1984e-17b1-4efc-9af9-94cec5835c91",
                "name": "Jackson Barton",
                "jersey": "66",
                "position": "OL",
                "sr_id": "sr:player:1227640",
                "depth": 3
              }
            ]
          }
        },
        {
          "position": {
            "name": "WR",
            "players": [
              {
                "id": "feeee40a-dd63-41a7-89cd-6c95b5456833",
                "name": "Hollywood Brown",
                "position": "WR",
                "sr_id": "sr:player:1234416",
                "depth": 1
              }
            ]
          }
        },
<season xmlns="http://feed.elasticstats.com/schema/football/depth_charts-v7.0.xsd" id="a538d200-e916-4272-aa07-b486094a1668" year="2023" type="REG" name="REG">
  <week id="b97007d7-03b1-4ef9-8fb1-d96d7abdb722" sequence="1" title="1"/>
  <depth_charts>
    <team id="de760528-1dc0-416a-a978-b510d20692ff" name="Cardinals" market="Arizona" alias="ARI" sr_id="sr:competitor:4412">
      <offense>
        <position name="TE">
          <player id="de3421f7-2147-4835-89a5-724e87bad463" name="Zach Ertz" jersey="86" position="TE" sr_id="sr:player:827633" depth="1"/>
          <player id="734d54cc-c869-4e2f-a60f-c59c493f5110" name="Trey McBride" jersey="85" position="TE" sr_id="sr:player:1473622" depth="2"/>
          <player id="d0f9112d-2496-450a-9fc5-d2d01b4d2454" name="Geoff Swaim" position="TE" sr_id="sr:player:855676" depth="3"/>
          <player id="a01b7698-d67f-4b60-b2fb-4c667336b718" name="Elijah Higgins" jersey="84" position="TE" sr_id="sr:player:1696253" depth="4"/>
        </position>
        <position name="LG">
          <player id="00fdaebe-c8f6-43fa-addb-6a57dc6c5969" name="Elijah Wilkinson" jersey="71" position="OL" sr_id="sr:player:1137927" depth="1"/>
          <player id="f1f4a350-cc5f-43a2-bde1-829058d6c338" name="Carter O'Donnell" position="OL" sr_id="sr:player:2040355" depth="2"/>
        </position>
        <position name="RG">
          <player id="3a39ab56-f188-4924-862d-c79ce67a3420" name="Will Hernandez" position="OL" sr_id="sr:player:1188454" depth="1"/>
          <player id="a3f67680-66f1-4efc-b21b-badd19467cc9" name="Trystan Colon" position="OL" sr_id="sr:player:1220306" depth="2"/>
        </position>
        <position name="WR">
          <player id="7fc949b6-a1cb-4f9d-a06d-b65773409a44" name="Zach Pascal" jersey="83" position="WR" sr_id="sr:player:1132243" depth="1"/>
          <player id="b91be982-fccd-448e-869b-e9b5148a1730" name="Michael Wilson" jersey="14" position="WR" sr_id="sr:player:1438988" depth="2"/>
        </position>
        <position name="RT">
          <player id="b46d84ef-d811-47f5-a6e2-586bfbc8f548" name="Paris Johnson Jr." jersey="70" position="OL" sr_id="sr:player:2001137" depth="1"/>
          <player id="d96246d7-aa2c-4d05-9c58-8d6bc5e20cdf" name="Kelvin Beachum" jersey="68" position="OL" sr_id="sr:player:829037" depth="2"/>
        </position>
        <position name="LT">
          <player id="90d9c6b2-3970-45e1-a558-b68a977a8995" name="D.J. Humphries" position="OL" sr_id="sr:player:834537" depth="1"/>
          <player id="2f58f750-e8f3-11ed-bb4e-979e408fed0c" name="Ilm Manning" position="OG" sr_id="sr:player:1477174" depth="2"/>
          <player id="adb1984e-17b1-4efc-9af9-94cec5835c91" name="Jackson Barton" position="OL" sr_id="sr:player:1227640" depth="3"/>
        </position>
        <position name="WR">
          <player id="feeee40a-dd63-41a7-89cd-6c95b5456833" name="Marquise Brown" jersey="5" position="WR" sr_id="sr:player:1234416" depth="1"/>
        </position>

When you query the Weekly Depth Charts feed, you’ll get the projected player lineup for each team in a given week of the season. The response includes season and week details, then lists each team with their offensive, defensive, and special teams units. For each position group (e.g., TE, WR, OL), you’ll receive an ordered list of players showing depth rank, along with identifiers, jersey numbers, and positions. Use this feed to display depth chart visualizations, track lineup changes week-to-week, or integrate projected starter and backup data into your fantasy, betting, or analytics applications.

The following example shows how you can visualize the Minnesota Vikings' offensive depth chart for week 8 of the 2023 season, detailing starters and their backups for each position.



Transactions

NFL transactions refer to the movements of players between teams through trades, free agency signings, releases, or waivers. A transaction becomes official when it is processed by the league office and reported in the NFL's daily transaction list.

You can access daily transaction updates using the Daily Transactions feed, which provides details of all transactions added or edited throughout each league-defined day.

Daily Transactions Response Snippet
{
  "league": {
    "id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
    "name": "National Football League",
    "alias": "NFL"
  },
  "start_time": "2023-08-17T04:00:00Z",
  "end_time": "2023-08-18T03:59:59Z",
  "players": [
    {
      "id": "f1236815-5ed7-4bab-808f-700c4516fd7d",
      "name": "Ja'Marcus Bradley",
      "first_name": "Ja'Marcus",
      "last_name": "Bradley",
      "position": "WR",
      "sr_id": "sr:player:2040191",
      "transactions": [
        {
          "id": "0677b0e0-3d41-11ee-a025-05d4d8fdbbd5",
          "desc": "The Pittsburgh Steelers waived WR Ja'Marcus Bradley due to injury.",
          "effective_date": "2023-08-17",
          "last_modified": "2023-08-17T21:01:37Z",
          "transaction_type": "Waived-Injury",
          "transaction_code": "WAI",
          "transaction_year": 2023,
          "status_before": "IR",
          "status_after": "UFA",
          "from_team": {
            "id": "cb2f9f1f-ac67-424e-9e72-1475cb0ed398",
            "name": "Steelers",
            "market": "Pittsburgh",
            "alias": "PIT",
            "sr_id": "sr:competitor:4345"
          }
        }
      ]
    },
    {
      "id": "932140a0-2d8e-11ee-8d33-c7332e65261c",
      "name": "Wayne Taulapapa",
      "first_name": "Wayne",
      "last_name": "Taulapapa",
      "position": "RB",
      "sr_id": "sr:player:1566260",
      "transactions": [
        {
          "id": "082538a0-3d27-11ee-8e11-abd7da5a6b0b",
          "desc": "The Seattle Seahawks waived RB Wayne Taulapapa.",
          "effective_date": "2023-08-17",
          "last_modified": "2023-08-17T17:54:14Z",
          "transaction_type": "Waived",
          "transaction_code": "WA",
          "transaction_year": 2023,
          "status_before": "ACT",
          "status_after": "UFA",
          "from_team": {
            "id": "3d08af9e-c767-4f88-a7dc-b920c6d2b4a8",
            "name": "Seahawks",
            "market": "Seattle",
            "alias": "SEA",
            "sr_id": "sr:competitor:4430"
          }
        }
      ]
    },
    {
      "id": "9e82eb73-21f0-469a-ac85-b4fde70a6a4e",
      "name": "Kemon Hall",
      "first_name": "Kemon",
      "last_name": "Hall",
      "position": "CB",
      "sr_id": "sr:player:1233490",
      "transactions": [
        {
          "id": "0aaa1a80-3d42-11ee-b431-29a52304560d",
          "desc": "The Los Angeles Chargers placed CB Kemon Hall on the IR, after being waived due to injury.",
          "effective_date": "2023-08-17",
          "last_modified": "2023-08-17T21:08:43Z",
          "transaction_type": "Placed on Injured Reserve",
          "transaction_code": "IR",
          "transaction_year": 2023,
          "status_before": "UFA",
          "status_after": "IR",
          "to_team": {
            "id": "1f6dcffb-9823-43cd-9ff4-e7a8466749b5",
            "name": "Chargers",
            "market": "Los Angeles",
            "alias": "LAC",
            "sr_id": "sr:competitor:4429"
          }
        }
      ]
    },
    {
      "id": "11e6adfb-8144-4990-adc2-bfcfe905889b",
      "name": "Buddy Johnson",
      "first_name": "Buddy",
      "last_name": "Johnson",
      "position": "LB",
      "sr_id": "sr:player:2198688",
      "transactions": [
        {
          "id": "1d472570-3d1a-11ee-b772-2d653603155d",
          "desc": "The Chicago Bears waived LB Buddy Johnson.",
          "effective_date": "2023-08-17",
          "last_modified": "2023-08-17T16:21:48Z",
          "transaction_type": "Waived-Injury",
          "transaction_code": "WAI",
          "transaction_year": 2023,
          "status_before": "ACT",
          "status_after": "UFA",
          "from_team": {
            "id": "7b112545-38e6-483c-a55c-96cf6ee49cb8",
            "name": "Bears",
            "market": "Chicago",
            "alias": "CHI",
            "sr_id": "sr:competitor:4391"
          }
        }
      ]
    },
    {
      "id": "2f243870-eb74-11ed-aecd-85bc826ed43e",
      "name": "Trevor Reid",
      "first_name": "Trevor",
      "last_name": "Reid",
      "position": "T",
      "sr_id": "sr:player:2067285",
      "transactions": [
        {
          "id": "273bb710-3d35-11ee-9cfd-8563fd4ebfa4",
          "desc": "The Atlanta Falcons signed T Trevor Reid.",
          "effective_date": "2023-08-17",
          "last_modified": "2023-08-17T19:35:38Z",
          "transaction_type": "Signed",
          "transaction_code": "SGN",
          "transaction_year": 2023,
          "status_before": "UFA",
          "status_after": "ACT",
          "to_team": {
            "id": "e6aa13a4-0055-48a9-bc41-be28dc106929",
            "name": "Falcons",
            "market": "Atlanta",
            "alias": "ATL",
            "sr_id": "sr:competitor:4393"
          }
        }
      ]
    },
<league xmlns="http://feed.elasticstats.com/schema/football/transactions-v7.0.xsd">
  <transactions start_time="2023-08-17T04:00:00Z" end_time="2023-08-18T03:59:59Z">
    <player id="f1236815-5ed7-4bab-808f-700c4516fd7d" name="Ja'Marcus Bradley" first_name="Ja'Marcus" last_name="Bradley" position="WR" sr_id="sr:player:2040191">
      <transaction id="0677b0e0-3d41-11ee-a025-05d4d8fdbbd5" desc="The Pittsburgh Steelers waived WR Ja'Marcus Bradley due to injury." effective_date="2023-08-17" last_modified="2023-08-17T21:01:37Z" transaction_type="Waived-Injury" transaction_code="WAI" transaction_year="2023" status_before="IR" status_after="UFA">
        <from_team id="cb2f9f1f-ac67-424e-9e72-1475cb0ed398" name="Steelers" market="Pittsburgh" alias="PIT" sr_id="sr:competitor:4345"/>
      </transaction>
    </player>
    <player id="932140a0-2d8e-11ee-8d33-c7332e65261c" name="Wayne Taulapapa" first_name="Wayne" last_name="Taulapapa" position="RB" sr_id="sr:player:1566260">
      <transaction id="082538a0-3d27-11ee-8e11-abd7da5a6b0b" desc="The Seattle Seahawks waived RB Wayne Taulapapa." effective_date="2023-08-17" last_modified="2023-08-17T17:54:14Z" transaction_type="Waived" transaction_code="WA" transaction_year="2023" status_before="ACT" status_after="UFA">
        <from_team id="3d08af9e-c767-4f88-a7dc-b920c6d2b4a8" name="Seahawks" market="Seattle" alias="SEA" sr_id="sr:competitor:4430"/>
      </transaction>
    </player>
    <player id="9e82eb73-21f0-469a-ac85-b4fde70a6a4e" name="Kemon Hall" first_name="Kemon" last_name="Hall" position="CB" sr_id="sr:player:1233490">
      <transaction id="0aaa1a80-3d42-11ee-b431-29a52304560d" desc="The Los Angeles Chargers placed CB Kemon Hall on the IR, after being waived due to injury." effective_date="2023-08-17" last_modified="2023-08-17T21:08:43Z" transaction_type="Placed on Injured Reserve" transaction_code="IR" transaction_year="2023" status_before="UFA" status_after="IR">
        <to_team id="1f6dcffb-9823-43cd-9ff4-e7a8466749b5" name="Chargers" market="Los Angeles" alias="LAC" sr_id="sr:competitor:4429"/>
      </transaction>
    </player>
    <player id="11e6adfb-8144-4990-adc2-bfcfe905889b" name="Buddy Johnson" first_name="Buddy" last_name="Johnson" position="LB" sr_id="sr:player:2198688">
      <transaction id="1d472570-3d1a-11ee-b772-2d653603155d" desc="The Chicago Bears waived LB Buddy Johnson." effective_date="2023-08-17" last_modified="2023-08-17T16:21:48Z" transaction_type="Waived-Injury" transaction_code="WAI" transaction_year="2023" status_before="ACT" status_after="UFA">
        <from_team id="7b112545-38e6-483c-a55c-96cf6ee49cb8" name="Bears" market="Chicago" alias="CHI" sr_id="sr:competitor:4391"/>
      </transaction>
    </player>
    <player id="2f243870-eb74-11ed-aecd-85bc826ed43e" name="Trevor Reid" first_name="Trevor" last_name="Reid" position="T" sr_id="sr:player:2067285">
      <transaction id="273bb710-3d35-11ee-9cfd-8563fd4ebfa4" desc="The Atlanta Falcons signed T Trevor Reid." effective_date="2023-08-17" last_modified="2023-08-17T19:35:38Z" transaction_type="Signed" transaction_code="SGN" transaction_year="2023" status_before="UFA" status_after="ACT">
        <to_team id="e6aa13a4-0055-48a9-bc41-be28dc106929" name="Falcons" market="Atlanta" alias="ATL" sr_id="sr:competitor:4393"/>
      </transaction>
    </player>

When you query the Daily Transactions feed, you’ll receive all player transaction activity within a specified 24-hour period. The response includes each player’s identifiers, name, and position, along with one or more transaction records detailing the action taken (Signed, Waived, Placed on Injured Reserve, etc.), a description, effective date, and before/after status. Team information is included for both the origin and destination, where applicable. Use this feed to update rosters, track player movement across the league, or trigger notifications in fantasy, betting, or news applications.

🏈

Waiving Players

In the NFL, the term "waive" refers to a process where players with less than four years of service time are put on the waiver wire, making them available for other teams to claim under the same contract conditions. If unclaimed, these players become unrestricted free agents. This system allows teams to potentially pick up young talent that has been let go by other teams.

🏈

Transaction and Code Types

For the full list of transaction and code types, visit our NFL FAQ.

👍

Track Effective Dates

To ensure accuracy in tracking player movements, always check the effective_date in transaction data as it specifies when changes officially take place.



Free Agents

Free agents are players who are not currently under contract with any team, allowing them to sign with any team of their choosing. The Free Agents endpoint provides detailed player information for all current free agents in the league.

Free Agents Response Snippet
{
  "league": {
    "id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
    "name": "National Football League",
    "alias": "NFL",
    "free_agents": [
      {
        "id": "0009fa10-ca24-11ec-9f1c-b7114d38a85b",
        "full_name": "Chris Owens",
        "first_name": "Chris",
        "last_name": "Owens",
        "abbr_name": "C.Owens",
        "height": 75,
        "weight": 305,
        "jersey_number": "0",
        "college": "Alabama",
        "high_school": "Lamar (TX)",
        "birth_place": "Arlington, TX, USA",
        "updated": "2025-08-13T16:46:39Z"
      },
      {
        "id": "000bc6c6-c9a8-4631-92d6-1cea5aaa1644",
        "full_name": "Austin Pasztor",
        "first_name": "Austin",
        "last_name": "Pasztor",
        "abbr_name": "A.Pasztor",
        "height": 79,
        "weight": 305,
        "jersey_number": "0",
        "college": "Virginia",
        "high_school": "Glendale (Ontario)",
        "birth_place": "Langton, ON, CAN",
        "updated": "2025-08-13T16:47:08Z"
      },
      {
        "id": "0015e8b2-924c-4dad-923b-52a804a584b1",
        "full_name": "Faquan Calhoun",
        "first_name": "Faquan",
        "last_name": "Calhoun",
        "abbr_name": "F.Calhoun",
        "height": 73,
        "weight": 205,
        "jersey_number": "0",
        "college": "Cumberland College",
        "birth_place": "Lebanon, KY, USA",
        "updated": "2022-04-10T01:08:03Z"
      },
      {
        "id": "001fc9cd-129f-4ad1-a3e4-212e5398add5",
        "full_name": "Anthony Ezeakunne",
        "first_name": "Anthony",
        "last_name": "Ezeakunne",
        "abbr_name": "A.Ezeakunne",
        "height": 76,
        "weight": 235,
        "jersey_number": "0",
        "college": "Chapman",
        "high_school": "West Torrance (CA)",
        "birth_place": "Wilmington, CA, USA",
        "updated": "2022-04-06T18:14:05Z"
      }
    ]
  }
}
<league xmlns="http://feed.elasticstats.com/schema/football/nfl/free-agents-v7.0.xsd" id="3c6d318a-6164-4290-9bbc-bf9bb21cc4b8" name="National Football League" alias="NFL">
  <free_agent id="0009fa10-ca24-11ec-9f1c-b7114d38a85b" full_name="Chris Owens" first_name="Chris" last_name="Owens" abbr_name="C.Owens" height="75" weight="305.0" jersey_number="0" college="Alabama" high_school="Lamar (TX)" birth_place="Arlington, TX, USA" updated="2025-08-13T16:46:39Z"/>
  <free_agent id="000bc6c6-c9a8-4631-92d6-1cea5aaa1644" full_name="Austin Pasztor" first_name="Austin" last_name="Pasztor" abbr_name="A.Pasztor" height="79" weight="305.0" jersey_number="0" college="Virginia" high_school="Glendale (Ontario)" birth_place="Langton, ON, CAN" updated="2025-08-13T16:47:08Z"/>
  <free_agent id="0015e8b2-924c-4dad-923b-52a804a584b1" full_name="Faquan Calhoun" first_name="Faquan" last_name="Calhoun" abbr_name="F.Calhoun" height="73" weight="205.0" jersey_number="0" college="Cumberland College" birth_place="Lebanon, KY, USA" updated="2022-04-10T01:08:03Z"/>
  <free_agent id="001fc9cd-129f-4ad1-a3e4-212e5398add5" full_name="Anthony Ezeakunne" first_name="Anthony" last_name="Ezeakunne" abbr_name="A.Ezeakunne" height="76" weight="235.0" jersey_number="0" college="Chapman" high_school="West Torrance (CA)" birth_place="Wilmington, CA, USA" updated="2022-04-06T18:14:05Z"/>

Use the Free Agents endpoint to track available players for potential signings or roster changes, and take it a step further by retrieving detailed player profiles for each free agent.



Daily Change Log

The Daily Change Log endpoint provides an efficient way to monitor daily updates within the NFL API, including roster adjustments, transactions, and corrections to player injury details, without exhausting your API call quota.

The table below outlines scenarios and use cases for utilizing the Daily Change Log based on team roster and player updates.

DataUse Case
Team RostersUse this data to keep track of adjustments like player trades, contract signings, or releases.
Game RostersUseful for verifying rosters after a game or adjustments to player participation.
TransactionsObserve adjustments or corrections to transaction data.
InjuriesObserve adjustments or corrections to player injury data.
Depth ChartsVerify or track adjustments to team depth charts.

Steps:

  1. Identify Change Types: First, review the Daily Change Log to identify the types of changes reported. These could be related to games, players, or teams. Each entry in the log will list relevant IDs (game, player, or team ID), depending on the type of change.

  2. Use IDs to Retrieve Specifics:

    • Game Roster Changes: If the ID is found within theresults node, this can indicate a post-game correction to the game roster. This ID is a game ID.
    • Player and Team Changes: Similarly, IDs associated with players or teams indicate changes relevant to these entities, such as updates to team rosters.
  3. Pull Detailed Data: Use the identified IDs to pull detailed information from the relevant feed. For example:

    • Team Rosters Feed: If a team ID is mentioned, you can pull this feed to check for any updates to team rosters.
    • Game Roster Feed: Use the game ID to retrieve updated game rosters and to see what specific data was altered.
  4. Verify Changes: After pulling the detailed data from the relevant feeds, compare the newly retrieved data against previously stored data to verify the changes and update your records accordingly.

⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates:

  • Entries populate live for changes to teams, players, game statistics, schedules, and standings.
  • Start time of the log is 05:00:00 UTC; end time is 04:59:59 UTC

For optimal results, set a regular schedule to pull every 10 minutes or less (depending on your use case) to access the feed.