Retrieving Rosters and Players
Eight feeds cover who is on an NFL roster, who is available this week, and who moved: Team Roster, Team Profile, Player Profile, Game Roster, Weekly Injuries, Weekly Depth Charts, Daily Transactions, and Free Agents. This scenario builds team and player pages and keeps them current.
An NFL roster is the list of players associated with a team, and three of these feeds are roster-specific: the full roster (Team Roster: active players, inactive players, and practice squad members), the active roster (Team Profile: active players only), and the declared game roster (Game Roster: which players from the full roster will be active for a specific game).
This scenario is commonly used to:
- Build team pages with full and active rosters, coaches, and franchise information
- Build player pages with biographical, draft, salary, and season data
- Show weekly availability: injuries, practice participation, and depth charts
- Track trades, signings, releases, waivers, and the free agent pool
Relevant Feeds
| Feed | Scope | Use |
|---|---|---|
| Team Roster | team GUID | Full roster (active, inactive, practice squad), coaches, franchise record, salaries |
| Team Profile | team GUID | Active roster only, with the same franchise record |
| Player Profile | player GUID | Bio, draft history, salary, cross-league references, per-season statistics |
| Game Roster | game GUID | Declared game roster with participation and in-game status |
| Weekly Injuries | season + week | Injury designations, practice status, estimated return dates |
| Weekly Depth Charts | season + week | Starters and backups by position |
| Daily Transactions | league day | Trades, signings, releases, waivers, list moves |
| Free Agents | league | Players not under contract with any team |
Integration Steps
Weekly Injuries and Weekly Depth Charts are keyed by season year, season type, and week, so confirm the season is listed before requesting them:
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.
1. Build the team page
The Team Roster feed carries the franchise record (founding year, current owner, general manager and president, mascot and fight song, championships, conference and division titles, playoff appearances), the coaching staff, and the full player list: active players, inactive players, and practice squad members. Player rows carry biographical detail (birth date, birthplace, high school, college and conference), rookie_year and experience, and, where reported, salary; a draft block and reference entries appear on players who have them: Team ids come from the Teams feed or the League Hierarchy; the Fundamentals page walks that catalog.
GET https://api.sportradar.com/nfl/official/trial/v7/en/teams/768c92aa-75ff-4a43-bcc0-f2798c2e1724/full_roster.json
x-api-key: YOUR_API_KEY{
"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": 25,
"coaches": [
{
"id": "2546eccb-38e4-486d-9c69-c7d5215eaf34",
"full_name": "Joe Brady",
"first_name": "Joe",
"last_name": "Brady",
"position": "Head Coach"
}
],
"players": [
{
"id": "038fe0a5-5e0c-4922-914d-4a6685499069",
"name": "Tommy Doman Jr.",
"jersey": "39",
"last_name": "Doman",
"first_name": "Tommy",
"abbr_name": "T.Doman",
"birth_date": "2002-09-01",
"weight": 214.0,
"height": 76,
"position": "P",
"birth_place": "Rochester Hills, MI, USA",
"high_school": "St. Mary's (MI)",
"college": "Florida",
"college_conf": "Southeastern Conference",
"rookie_year": 2026,
"status": "ACT",
"sr_id": "sr:player:2151560",
"name_suffix": "Jr.",
"experience": 0
},
{
"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": 267.0,
"height": 76,
"position": "OLB",
"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": 6,
"salary": 4488000
}
]
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-09-01 02:32:02 +0000 -->
<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="25">
<coaches>
<coach id="2546eccb-38e4-486d-9c69-c7d5215eaf34" full_name="Joe Brady" first_name="Joe" last_name="Brady" position="Head Coach"/>
<!-- ... omitted for brevity -->
</coaches>
<players>
<player id="038fe0a5-5e0c-4922-914d-4a6685499069" name="Tommy Doman Jr." jersey="39" last_name="Doman" first_name="Tommy" abbr_name="T.Doman" birth_date="2002-09-01" weight="214.0" height="76" position="P" birth_place="Rochester Hills, MI, USA" high_school="St. Mary's (MI)" college="Florida" college_conf="Southeastern Conference" rookie_year="2026" status="ACT" sr_id="sr:player:2151560" name_suffix="Jr." experience="0">
<draft year="2026" round="7" number="239">
<team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376"/>
</draft>
<reference source_id="8e1ad79d-8399-4a88-9f16-64f9837d36c5" 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="267.0" height="76" position="OLB" 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="6" salary="4488000">
<reference source_id="52835"/>
<reference source_id="00-0035933"/>
</player>
<!-- ... omitted for brevity -->
</players>
<!-- ... omitted for brevity -->
</team>
<!-- Generation ended @ 2026-09-01 02:32:02 +0000 -->The response is shown trimmed to one coach and two players; the full roster returns every player on the team. The reference entries show a player's corresponding ID in another league's API, such as an NFL player's NCAAFB record, so you can connect data across leagues; the scope value names the league the ID came from. Salaries on the Team Roster and Team Profile support payroll analysis, player earnings comparisons, and salary cap tooling.
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.
The Team Profile feed returns the same franchise record and coaching staff with the active roster only:
GET https://api.sportradar.com/nfl/official/trial/v7/en/teams/768c92aa-75ff-4a43-bcc0-f2798c2e1724/profile.json
x-api-key: YOUR_API_KEY{
"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": 25,
"coaches": [
{
"id": "2546eccb-38e4-486d-9c69-c7d5215eaf34",
"full_name": "Joe Brady",
"first_name": "Joe",
"last_name": "Brady",
"position": "Head Coach"
}
],
"players": [
{
"id": "038fe0a5-5e0c-4922-914d-4a6685499069",
"name": "Tommy Doman Jr.",
"jersey": "39",
"last_name": "Doman",
"first_name": "Tommy",
"abbr_name": "T.Doman",
"birth_date": "2002-09-01",
"weight": 214.0,
"height": 76,
"position": "P",
"birth_place": "Rochester Hills, MI, USA",
"high_school": "St. Mary's (MI)",
"college": "Florida",
"college_conf": "Southeastern Conference",
"rookie_year": 2026,
"status": "ACT",
"sr_id": "sr:player:2151560",
"name_suffix": "Jr.",
"experience": 0
}
]
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-08-31 21:34:00 +0000 -->
<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="25">
<coaches>
<coach id="2546eccb-38e4-486d-9c69-c7d5215eaf34" full_name="Joe Brady" first_name="Joe" last_name="Brady" position="Head Coach"/>
<!-- ... omitted for brevity -->
</coaches>
<players>
<player id="038fe0a5-5e0c-4922-914d-4a6685499069" name="Tommy Doman Jr." jersey="39" last_name="Doman" first_name="Tommy" abbr_name="T.Doman" birth_date="2002-09-01" weight="214.0" height="76" position="P" birth_place="Rochester Hills, MI, USA" high_school="St. Mary's (MI)" college="Florida" college_conf="Southeastern Conference" rookie_year="2026" status="ACT" sr_id="sr:player:2151560" name_suffix="Jr." experience="0">
<draft year="2026" round="7" number="239">
<team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376"/>
</draft>
<reference source_id="8e1ad79d-8399-4a88-9f16-64f9837d36c5" scope="NCAAFB" id_type="league_profile"/>
</player>
<!-- ... omitted for brevity -->
</players>
<!-- ... omitted for brevity -->
</team>
<!-- Generation ended @ 2026-08-31 21:34:00 +0000 -->The response is shown trimmed to one coach and one player. The following is an example of how you can display a team roster on your platform, showcasing player names, jersey numbers, positions, height, weight, and college:
The headshot slots are placeholders: team logos and player headshots come from the Images API.
2. Drill into Player Profiles
The Player Profile feed goes beyond roster data: biographical detail, the current team, the draft block (year, round, pick number, and the drafting team), salary, cross-league references, and a seasons[] array with one entry per season and season type played, each carrying that stint's team and statistics:
GET https://api.sportradar.com/nfl/official/trial/v7/en/players/3069db07-aa43-4503-ab11-2ae5c0002721/profile.json
x-api-key: YOUR_API_KEY{
"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": 9,
"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": "00-0034857"
},
{
"source_id": "46076"
}
],
"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"
}
]
}
]
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-08-30 20:39:03 +0000 -->
<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="9" 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="00-0034857"/>
<reference source_id="46076"/>
<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">
<!-- ... omitted for brevity -->
</team>
</season>
<!-- ... omitted for brevity -->
<!-- ... omitted for brevity -->
</player>
<!-- Generation ended @ 2026-08-30 20:39:03 +0000 -->The response is shown trimmed to one season entry with its statistics omitted; the full profile carries complete statistics per stint. The following is an example of how you can display player profile data on your platform, showcasing a seasonal stat summary alongside the player's number, position, and team:
3. Read game-day availability
The Game Roster feed shows the declared game roster: which players from the full roster are active for a specific game. Player rows carry two signals: status is the overall game status of a player (deactivated, did not play (dnp), played, or started), and in_game_status the player's condition during the game (active, probable, questionable, doubtful, out, benched, or unknown). in_game_status updates live, so the Game Roster doubles as an in-game availability tracker:
GET https://api.sportradar.com/nfl/official/trial/v7/en/games/7391a8d0-6675-4305-92fc-dc65bb4dcd38/roster.json
x-api-key: YOUR_API_KEY{
"id": "7391a8d0-6675-4305-92fc-dc65bb4dcd38",
"status": "closed",
"scheduled": "2026-02-08T23:30:00+00:00",
"attendance": 70823,
"entry_mode": "LDE",
"clock": "00:00",
"quarter": 4,
"sr_id": "sr:match:67426020",
"neutral_site": true,
"game_type": "playoff",
"conference_game": false,
"title": "Super Bowl LX",
"duration": "3:42",
"parent_id": "f6c2b12d-966c-41a5-98a7-054620fba38b",
"home": {
"id": "97354895-8c77-4fd4-a860-32e62ea7382a",
"name": "Patriots",
"market": "New England",
"alias": "NE",
"sr_id": "sr:competitor:4424",
"players": [
{
"id": "acdd0b8b-d840-44ac-9dfa-05fe8baabe09",
"name": "Garrett Bradbury",
"jersey": "65",
"last_name": "Bradbury",
"first_name": "Garrett",
"abbr_name": "G.Bradbury",
"birth_date": "1995-06-20",
"weight": 300.0,
"height": 75,
"position": "C",
"age": 30,
"birth_place": "Charlotte, NC, USA",
"high_school": "Charlotte Christian (NC)",
"college": "North Carolina State",
"college_conf": "Atlantic Coast Conference",
"rookie_year": 2019,
"status": "started",
"sr_id": "sr:player:1208540",
"in_game_status": "active"
}
]
},
"away": {
"id": "3d08af9e-c767-4f88-a7dc-b920c6d2b4a8",
"name": "Seahawks",
"market": "Seattle",
"alias": "SEA",
"sr_id": "sr:competitor:4430",
"players": [
{
"id": "e676e6be-88c7-4386-bf48-de8293cc3ba2",
"name": "Mason Richman",
"jersey": "78",
"last_name": "Richman",
"first_name": "Mason",
"abbr_name": "M.Richman",
"birth_date": "2002-05-07",
"weight": 307.0,
"height": 77,
"position": "OL",
"age": 23,
"birth_place": "Leawood, KS, USA",
"high_school": "Blue Valley (KS)",
"college": "Iowa",
"college_conf": "Big Ten Conference",
"rookie_year": 2025,
"status": "deactivated",
"sr_id": "sr:player:1998769",
"in_game_status": "active"
}
]
}
}<?xml version="1.0" ?>
<?xml-stylesheet type="text/xsl" charset="UTF-8" href="/xslt/football/roster-v7.0.xsl"?>
<!-- Generation started @ 2026-08-03 20:12:00 +0000 -->
<game xmlns="http://feed.elasticstats.com/schema/football/roster-v7.0.xsd" id="7391a8d0-6675-4305-92fc-dc65bb4dcd38" status="closed" scheduled="2026-02-08T23:30:00+00:00" attendance="70823" entry_mode="LDE" clock="00:00" quarter="4" sr_id="sr:match:67426020" neutral_site="true" game_type="playoff" conference_game="false" title="Super Bowl LX" duration="3:42" parent_id="f6c2b12d-966c-41a5-98a7-054620fba38b">
<home id="97354895-8c77-4fd4-a860-32e62ea7382a" name="Patriots" market="New England" alias="NE" sr_id="sr:competitor:4424">
<player id="acdd0b8b-d840-44ac-9dfa-05fe8baabe09" name="Garrett Bradbury" jersey="65" last_name="Bradbury" first_name="Garrett" abbr_name="G.Bradbury" birth_date="1995-06-20" weight="300.0" height="75" position="C" age="30" birth_place="Charlotte, NC, USA" high_school="Charlotte Christian (NC)" college="North Carolina State" college_conf="Atlantic Coast Conference" rookie_year="2019" status="started" sr_id="sr:player:1208540" in_game_status="active">
<draft year="2019" round="1" number="18">
<team id="33405046-04ee-4058-a950-d606f8c30852" name="Vikings" market="Minnesota" alias="MIN" sr_id="sr:competitor:4423"/>
</draft>
</player>
<!-- ... omitted for brevity -->
<!-- ... omitted for brevity -->
</home>
<away id="3d08af9e-c767-4f88-a7dc-b920c6d2b4a8" name="Seahawks" market="Seattle" alias="SEA" sr_id="sr:competitor:4430">
<player id="e676e6be-88c7-4386-bf48-de8293cc3ba2" name="Mason Richman" jersey="78" last_name="Richman" first_name="Mason" abbr_name="M.Richman" birth_date="2002-05-07" weight="307.0" height="77" position="OL" age="23" birth_place="Leawood, KS, USA" high_school="Blue Valley (KS)" college="Iowa" college_conf="Big Ten Conference" rookie_year="2025" status="deactivated" sr_id="sr:player:1998769" in_game_status="active">
<draft year="2025" round="7" number="234">
<team id="3d08af9e-c767-4f88-a7dc-b920c6d2b4a8" name="Seahawks" market="Seattle" alias="SEA" sr_id="sr:competitor:4430"/>
</draft>
</player>
<!-- ... omitted for brevity -->
<!-- ... omitted for brevity -->
</away>
<!-- ... omitted for brevity -->
</game>
<!-- Generation ended @ 2026-08-03 20:12:00 +0000 -->The response is shown trimmed to one player per team. For play-by-play and statistics during the game, see Tracking Live Games.
4. Track weekly availability
Weekly Injuries lists the injured players for each team for a given week, with the injury (primary), a game-status designation (Out in the sample), the status_date, and a practice participation status. The designation can be absent while a player still appears with a practice note. When a return can be projected, an entry also carries an estimated_return_date; this field appears on the Weekly Injuries feed only:
GET https://api.sportradar.com/nfl/official/trial/v7/en/seasons/2025/REG/10/injuries.json
x-api-key: YOUR_API_KEY{
"season": {
"id": "fbe26310-feb8-11ef-a86e-d5de4289b45b",
"year": 2025,
"type": "REG",
"name": "REG"
},
"week": {
"id": "84becc41-a5f7-48a5-bd02-c2ba6c99c6b5",
"sequence": 10,
"title": "10"
},
"teams": [
{
"id": "f7ddd7fa-0bae-4f90-bc8e-669e4d6cf2de",
"name": "Jaguars",
"market": "Jacksonville",
"alias": "JAX",
"sr_id": "sr:competitor:4386",
"players": [
{
"id": "7ff68f1d-204c-4d49-9179-ecb2514094dc",
"name": "Jourdan Lewis",
"jersey": "2",
"position": "CB",
"sr_id": "sr:player:1129859",
"injuries": [
{
"status": "Out",
"status_date": "2025-11-07T00:00:00+00:00",
"practice": {
"status": "Did Not Participate In Practice"
},
"primary": "Neck"
}
]
},
{
"id": "0fb60ada-bdd3-4d74-8c98-058303a1649a",
"name": "Dyami Brown",
"jersey": "5",
"position": "WR",
"sr_id": "sr:player:1412477",
"injuries": [
{
"status_date": "2025-11-07T00:00:00+00:00",
"practice": {
"status": "Full Participation In Practice"
},
"primary": "Concussion"
}
]
}
]
}
]
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-08-21 13:37:56 +0000 -->
<season xmlns="http://feed.elasticstats.com/schema/football/injuries-v7.0.xsd" id="fbe26310-feb8-11ef-a86e-d5de4289b45b" year="2025" type="REG" name="REG">
<week id="84becc41-a5f7-48a5-bd02-c2ba6c99c6b5" sequence="10" title="10"/>
<injuries>
<team id="f7ddd7fa-0bae-4f90-bc8e-669e4d6cf2de" name="Jaguars" market="Jacksonville" alias="JAX" sr_id="sr:competitor:4386">
<player id="7ff68f1d-204c-4d49-9179-ecb2514094dc" name="Jourdan Lewis" jersey="2" position="CB" sr_id="sr:player:1129859">
<injury status="Out" status_date="2025-11-07T00:00:00+00:00">
<practice status="Did Not Participate In Practice"/>
<primary>Neck</primary>
</injury>
</player>
<player id="0fb60ada-bdd3-4d74-8c98-058303a1649a" name="Dyami Brown" jersey="5" position="WR" sr_id="sr:player:2197676">
<injury status_date="2025-11-07T00:00:00+00:00">
<practice status="Full Participation In Practice"/>
<primary>Concussion</primary>
</injury>
</player>
<!-- ... omitted for brevity -->
</team>
<!-- ... omitted for brevity -->
</injuries>
</season>
<!-- Generation ended @ 2026-08-21 13:37:56 +0000 -->The response is shown trimmed to one team and two players. The rows render as an injury report card:
NFL depth charts list a team's players in order of position and playing status: the starters and the backups at each position, indicating who would step in during a game if a starter were unavailable due to injury or other reasons. Weekly Depth Charts provides each team's chart for a given week, arranged by unit (offense in the sample) and position with a depth order per player. Charts are published from the start of training camp in July through the Super Bowl. Each chart is scoped to a season and week, so requests for a new league year begin answering once the season is created (typically late February) and return an empty response until the first Preseason week 1 charts are published at training camp:
GET https://api.sportradar.com/nfl/official/trial/v7/en/seasons/2025/REG/10/depth_charts.json
x-api-key: YOUR_API_KEY{
"season": {
"id": "fbe26310-feb8-11ef-a86e-d5de4289b45b",
"year": 2025,
"type": "REG",
"name": "REG"
},
"week": {
"id": "84becc41-a5f7-48a5-bd02-c2ba6c99c6b5",
"sequence": 10,
"title": "10"
},
"teams": [
{
"id": "de760528-1dc0-416a-a978-b510d20692ff",
"name": "Cardinals",
"market": "Arizona",
"alias": "ARI",
"sr_id": "sr:competitor:4412",
"offense": [
{
"position": {
"name": "LG",
"players": [
{
"id": "da31074f-8268-4f34-b0c6-0ffbfc2fb4ad",
"name": "Isaiah Adams",
"jersey": "74",
"position": "OL",
"sr_id": "sr:player:2294885",
"depth": 1
},
{
"id": "3a39ab56-f188-4924-862d-c79ce67a3420",
"name": "Will Hernandez",
"jersey": "76",
"position": "OL",
"sr_id": "sr:player:1188454",
"depth": 2
}
]
}
},
{
"position": {
"name": "RWR",
"players": [
{
"id": "a28f7368-0306-4d20-855f-285a1a09c09c",
"name": "Zay Jones",
"jersey": "17",
"position": "WR",
"sr_id": "sr:player:1129793",
"depth": 1
},
{
"id": "ffd59710-0582-11ef-823c-c3942ac17525",
"name": "Xavier Weaver",
"jersey": "89",
"position": "WR",
"sr_id": "sr:player:1699399",
"depth": 2
}
]
}
}
]
}
]
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-08-21 13:37:35 +0000 -->
<season xmlns="http://feed.elasticstats.com/schema/football/depth_charts-v7.0.xsd" id="fbe26310-feb8-11ef-a86e-d5de4289b45b" year="2025" type="REG" name="REG">
<week id="84becc41-a5f7-48a5-bd02-c2ba6c99c6b5" sequence="10" title="10"/>
<depth_charts>
<team id="de760528-1dc0-416a-a978-b510d20692ff" name="Cardinals" market="Arizona" alias="ARI" sr_id="sr:competitor:4412">
<offense>
<position name="LG">
<player id="da31074f-8268-4f34-b0c6-0ffbfc2fb4ad" name="Isaiah Adams" jersey="74" position="OL" sr_id="sr:player:2294885" depth="1"/>
<player id="3a39ab56-f188-4924-862d-c79ce67a3420" name="Will Hernandez" jersey="76" position="OL" sr_id="sr:player:1188454" depth="2"/>
</position>
<position name="RWR">
<player id="a28f7368-0306-4d20-855f-285a1a09c09c" name="Zay Jones" jersey="17" position="WR" sr_id="sr:player:1129793" depth="1"/>
<player id="ffd59710-0582-11ef-823c-c3942ac17525" name="Xavier Weaver" jersey="89" position="WR" sr_id="sr:player:1699399" depth="2"/>
</position>
<!-- ... omitted for brevity -->
</offense>
<!-- ... omitted for brevity -->
</team>
<!-- ... omitted for brevity -->
</depth_charts>
</season>
<!-- Generation ended @ 2026-08-21 13:37:35 +0000 -->The response is shown trimmed to one team and two positions.
Offseason Depth ChartsDepth charts are not monitored in the offseason. You can still request them using
seasons/{season_year}/PRE/1/depth_charts, but don't expect a full response from the call until the start of training camp.
The following example shows how you can visualize the Bills' offensive depth chart for week 10 of the 2025 season, detailing starters and their backups for each position:
5. Track player movement
NFL transactions are 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. Daily Transactions returns every transaction added or edited during a league-defined day (04:00:00Z to 03:59:59Z), each with a description, a transaction_type and transaction_code, the effective_date, the player's status before and after, and the teams involved:
GET https://api.sportradar.com/nfl/official/trial/v7/en/league/2026/08/26/transactions.json
x-api-key: YOUR_API_KEY{
"league": {
"id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
"name": "National Football League",
"alias": "NFL"
},
"start_time": "2026-08-26T04:00:00Z",
"end_time": "2026-08-27T03:59:59Z",
"players": [
{
"id": "22b01678-952c-4923-b1a9-1249aa1e0791",
"name": "Kobe King",
"first_name": "Kobe",
"last_name": "King",
"position": "LB",
"sr_id": "sr:player:2152164",
"transactions": [
{
"id": "040aff10-a193-11f1-ace0-dfb38b033194",
"desc": "The New York Jets waived LB Kobe King due to injury.",
"effective_date": "2026-08-26",
"last_modified": "2026-08-26T21:14:03+00:00",
"transaction_type": "Waived-Injury",
"transaction_code": "WAI",
"transaction_year": 2026,
"status_before": "IR",
"status_after": "UFA",
"from_team": {
"id": "5fee86ae-74ab-4bdd-8416-42a9dd9964f3",
"name": "Jets",
"market": "New York",
"alias": "NYJ",
"sr_id": "sr:competitor:4427"
}
}
]
},
{
"id": "22febe45-170a-4f01-b144-3b35b44c7da4",
"name": "Danny Pinter",
"first_name": "Danny",
"last_name": "Pinter",
"jersey": "63",
"position": "C",
"sr_id": "sr:player:1226866",
"transactions": [
{
"id": "0a53dfb0-a15f-11f1-929a-d322de85f75f",
"desc": "The Baltimore Ravens placed C Danny Pinter on IR.",
"effective_date": "2026-08-26",
"last_modified": "2026-08-26T15:02:14+00:00",
"transaction_type": "Placed on Injured Reserve",
"transaction_code": "IR",
"transaction_year": 2026,
"status_before": "ACT",
"status_after": "IR",
"from_team": {
"id": "ebd87119-b331-4469-9ea6-d51fe3ce2f1c",
"name": "Ravens",
"market": "Baltimore",
"alias": "BAL",
"sr_id": "sr:competitor:4413"
},
"to_team": {
"id": "ebd87119-b331-4469-9ea6-d51fe3ce2f1c",
"name": "Ravens",
"market": "Baltimore",
"alias": "BAL",
"sr_id": "sr:competitor:4413"
}
}
]
}
]
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-09-01 09:09:28 +0000 -->
<league xmlns="http://feed.elasticstats.com/schema/football/transactions-v7.0.xsd">
<transactions start_time="2026-08-26T04:00:00Z" end_time="2026-08-27T03:59:59Z">
<player id="22b01678-952c-4923-b1a9-1249aa1e0791" name="Kobe King" first_name="Kobe" last_name="King" position="LB" sr_id="sr:player:2152164">
<transaction id="040aff10-a193-11f1-ace0-dfb38b033194" desc="The New York Jets waived LB Kobe King due to injury." effective_date="2026-08-26" last_modified="2026-08-26T21:14:03+00:00" transaction_type="Waived-Injury" transaction_code="WAI" transaction_year="2026" status_before="IR" status_after="UFA">
<from_team id="5fee86ae-74ab-4bdd-8416-42a9dd9964f3" name="Jets" market="New York" alias="NYJ" sr_id="sr:competitor:4427"/>
</transaction>
</player>
<player id="22febe45-170a-4f01-b144-3b35b44c7da4" name="Danny Pinter" first_name="Danny" last_name="Pinter" jersey="63" position="C" sr_id="sr:player:1226866">
<transaction id="0a53dfb0-a15f-11f1-929a-d322de85f75f" desc="The Baltimore Ravens placed C Danny Pinter on IR." effective_date="2026-08-26" last_modified="2026-08-26T15:02:14+00:00" transaction_type="Placed on Injured Reserve" transaction_code="IR" transaction_year="2026" status_before="ACT" status_after="IR">
<from_team id="ebd87119-b331-4469-9ea6-d51fe3ce2f1c" name="Ravens" market="Baltimore" alias="BAL" sr_id="sr:competitor:4413"/>
<to_team id="ebd87119-b331-4469-9ea6-d51fe3ce2f1c" name="Ravens" market="Baltimore" alias="BAL" sr_id="sr:competitor:4413"/>
</transaction>
</player>
<!-- ... omitted for brevity -->
</transactions>
</league>
<!-- Generation ended @ 2026-09-01 09:09:28 +0000 -->The response is shown trimmed to two players. Always check the effective_date when tracking player movement: it specifies when a change officially takes place. The full list of transaction and code types is in the NFL FAQ.
Waiving playersIn 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.
Free agents are players who are not currently under contract with any team, allowing them to sign with any team of their choosing. Free Agents lists every current free agent in the league with biographical detail and an updated timestamp:
GET https://api.sportradar.com/nfl/official/trial/v7/en/league/free_agents.json
x-api-key: YOUR_API_KEY{
"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.0,
"jersey_number": "0",
"college": "Alabama",
"high_school": "Lamar (TX)",
"birth_place": "Arlington, TX, USA",
"updated": "2025-08-13T16:46:39+00:00"
},
{
"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:08+00:00"
},
{
"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:03+00:00"
}
]
}
}<?xml version="1.0" ?>
<!-- Generation started @ 2026-09-01 09:09:33 +0000 -->
<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:39+00:00"/>
<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:08+00:00"/>
<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:03+00:00"/>
<!-- ... omitted for brevity -->
</league>
<!-- Generation ended @ 2026-09-01 09:09:35 +0000 -->The response is shown trimmed to three players. Use the feed to track available players for potential signings or roster changes, then retrieve each free agent's Player Profile for the detail:
Player Statuses and Positions
Roster rows carry a league status such as ACT (active); transaction entries record the status before and after a move, such as IR (injured reserve) and UFA (unrestricted free agent) above. The NFL FAQ lists the complete set of transaction and code types. Game Roster rows carry a separate participation status (deactivated, dnp, played, started) and an in_game_status. Depth chart positions are chart slots (LG, RWR) while roster and profile positions stay generic (OL, WR), so a player's depth-chart slot can differ from the position on their profile.
Best Practices
- Key players by GUID; jersey numbers and even positions change
- Expect seasonal rosters and depth charts to update throughout the season, transactions to update as movement occurs, and rosters and injury reports to be reviewed daily; during high-volume windows such as final roster cutdowns, allow a response's cache TTL to pass before treating a roster as settled (Update Frequencies describes how caching and invalidation interact)
- For when roster, injury, and player participation data is added during the week, see the NFL Data Entry Workflow
- Draft coverage runs from the 2019 draft onward; the Tracking the Draft scenario covers prospects, picks, and trades
- Treat the Daily Change Log as the trigger to refresh: it lists roster adjustments, transactions, and corrections to player injury details without exhausting your API call quota, so a team ID means re-pull that Team Roster, a game ID in
resultsa post-game Game Roster correction, and a player ID that Player Profile. Poll it every 10 minutes or less depending on your use case; Monitoring Data Changes carries the roster scenario table and the full workflow - Pull Weekly Injuries and Depth Charts on game-week cadence; they are weekly report feeds, not live feeds
- Treat the Game Roster as the game-day truth for who dressed and started; the Team Roster is the contract-level view and the Team Profile the active-roster view
- For recommended pull intervals and timing for each roster-related feed, see Update Frequencies
Updated 12 days ago