ID Handling
Intro to IDs
Our NFL API features a number of unique identifiers. Some IDs are needed to request feeds, while others signify unique data.
IDs can be attributed to leagues, conferences, divisions, franchises, teams, venues, drafts, weeks, periods, quarters, coaches, managers, prospects, draft picks, trades, transactions, drives, possessions, plays, in-game events, and many other variables.
ID Types
There are two primary ID types attributed to a variety of variables:
- UUIDs (Universally Unique Identifiers)
- SR IDs (Sportradar Identifiers)
Each directly identifies a given variable within the API, across multiple Sportradar APIs, or within data outside of Sportradar. The forms of IDs within the NFL API are detailed below.
UUID IDs
These are the primary IDs we suggest to implement in your integration.
UUIDs follow a specific structure: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
You'll see these UUIDs for teams, players, games, seasons, and more.
<team id="c5a59daa-53a7-4de0-851f-fb12be893e9e" name="Lions" market="Detroit" alias="DET" reference="4985" sr_id="sr:competitor:4419"></team>
SR IDs
These IDs correlate to our General Sport APIs, in this case the Global American Football API. They can have a varying structure but always begin with sr: and end with a number.
<code><competitor id="sr:competitor:4419" name="Detroit Lions" country="USA" country_code="USA" abbreviation="DET"/></code>
These IDs may appear as an id or a sr_id in various APIs.
<code><team id="c5a59daa-53a7-4de0-851f-fb12be893e9e" name="Lions" market="Detroit" alias="DET" reference="4985" sr_id="sr:competitor:4419"/></code>
Important Note
The
sr_idis an optional value in the NFL API and it’s strongly encouraged to utilize the UUIDs as your primary key. If you are integrating with the Global American Football API or any of our Odds APIs, the sr_ids will be needed.
IDs in other SR Products
NCAA Football
Most NFL players have previous experience in NCAA Football, and thus have profiles and IDs within the NCAA Football API. However, these unique IDs do not transfer to the NFL API.
Players drafted from NCAA Football are added to their NFL teams within a few days after the NFL Draft. Any undrafted free agents will also be added when those signings are announced. All of these player IDs will be separate across APIs.
NCAA API player IDs will be present in the NFL Draft feeds under source_id. This can be used to link profiles across systems if necessary.
<code><player id="acc141bf-531f-4576-8ac4-3f91c850293e" source_id="e9d4ab78-3572-47ab-b4d3-e04c5af231f3" first_name="Martavis" last_name="Bryant" sr_id="sr:player:829235" position="WR"/></code>
For any player absent from the Draft feeds, the best method of linking their profile from the NFL API is to utilize bio information, such as their name, college, and position.
You may also leverage the Mapping Feeds within the Global American Football API should you need to link Sportradar IDs. These Mapping feeds provide id and sr_id links for teams, players, games, and seasons.
<mapping external_id="e95bb7e5-4d32-4506-9aaf-7b7a3b47bb73" id="sr:competitor:494196"/>
<mapping external_id="0c89b920-116b-11ef-b1a7-c9f2f14cc42a" id="sr:competitor:449853"/>
<mapping external_id="7106ebd0-dbf7-4202-a06d-915e8073e317" id="sr:competitor:605632"/>
<mapping external_id="5894d650-0c9e-11ef-8c2a-6d54ed8a6bb6" id="sr:competitor:477332"/>
<mapping external_id="2ed1462d-6670-4094-a86d-d723ae3b1886" id="sr:competitor:469435"/>
<mapping external_id="c20d68a0-bf6a-11ec-ae8f-61910aa49b1d" id="sr:player:2813447"/>
<mapping external_id="17c1acd0-bf6a-11ec-ae8f-61910aa49b1d" id="sr:player:2813449"/>
<mapping external_id="a29e6170-be81-11ec-8f27-93ad27be641d" id="sr:player:2813445"/>
<mapping external_id="6be609d0-bc56-11ec-9f75-8946793d8f77" id="sr:player:2813443"/>
<mapping external_id="809ec8a0-be7a-11ec-bd7d-51849f23b465" id="sr:player:2813441"/>
<mapping external_id="5ca22b1c-3ede-4a91-bbe8-456179e8e230" id="sr:sport_event:50733635"/>
<mapping external_id="ab166a44-3adb-4195-ab29-ca60eb2ea7c8" id="sr:sport_event:50690883"/>
<mapping external_id="a75e6ddd-6570-4584-9323-9bb363f40cf3" id="sr:sport_event:50690877"/>
<mapping external_id="eee98b92-75b6-474e-a27f-43e562baeb2b" id="sr:sport_event:50690787"/>
<mapping external_id="dbfa2bd2-15c2-46a6-bfd4-75b8543a970a" id="sr:sport_event:50690785"/>
<mapping external_id="NFL-2024-REG" id="sr:season:115087"/>
<mapping external_id="NCAAFB-2024-REG" id="sr:season:114685"/>
<mapping external_id="NFL-2024-PRE" id="sr:season:117071"/>
<mapping external_id="NFL-2023-PST" id="sr:season:102797"/>
<mapping external_id="NFL-2023-PRE" id="sr:season:105129"/>
UFL
Player and venue IDs from the NFL API are not synched to the UFL API. However, players and venues from the USFL API database were transferred to the UFL database, so those IDs will match.
The Sportradar IDs will be consistent across sports and leagues, where available.
Global American Football
The Global American Football API covers NFL data at a much lower tier, and is based on the sr_id system, with IDs that look like: sr:competitor:4419 or sr:sport_event:50690883.
Make use of the Mapping Feeds within Global American Football should you need to link IDs between APIs. These feeds provide id and sr_id links for teams, players, games, and seasons.
<mapping external_id="e95bb7e5-4d32-4506-9aaf-7b7a3b47bb73" id="sr:competitor:494196"/>
<mapping external_id="0c89b920-116b-11ef-b1a7-c9f2f14cc42a" id="sr:competitor:449853"/>
<mapping external_id="7106ebd0-dbf7-4202-a06d-915e8073e317" id="sr:competitor:605632"/>
<mapping external_id="5894d650-0c9e-11ef-8c2a-6d54ed8a6bb6" id="sr:competitor:477332"/>
<mapping external_id="2ed1462d-6670-4094-a86d-d723ae3b1886" id="sr:competitor:469435"/>
<mapping external_id="c20d68a0-bf6a-11ec-ae8f-61910aa49b1d" id="sr:player:2813447"/>
<mapping external_id="17c1acd0-bf6a-11ec-ae8f-61910aa49b1d" id="sr:player:2813449"/>
<mapping external_id="a29e6170-be81-11ec-8f27-93ad27be641d" id="sr:player:2813445"/>
<mapping external_id="6be609d0-bc56-11ec-9f75-8946793d8f77" id="sr:player:2813443"/>
<mapping external_id="809ec8a0-be7a-11ec-bd7d-51849f23b465" id="sr:player:2813441"/>
<mapping external_id="5ca22b1c-3ede-4a91-bbe8-456179e8e230" id="sr:sport_event:50733635"/>
<mapping external_id="ab166a44-3adb-4195-ab29-ca60eb2ea7c8" id="sr:sport_event:50690883"/>
<mapping external_id="a75e6ddd-6570-4584-9323-9bb363f40cf3" id="sr:sport_event:50690877"/>
<mapping external_id="eee98b92-75b6-474e-a27f-43e562baeb2b" id="sr:sport_event:50690787"/>
<mapping external_id="dbfa2bd2-15c2-46a6-bfd4-75b8543a970a" id="sr:sport_event:50690785"/>
<mapping external_id="NFL-2024-REG" id="sr:season:115087"/>
<mapping external_id="NCAAFB-2024-REG" id="sr:season:114685"/>
<mapping external_id="NFL-2024-PRE" id="sr:season:117071"/>
<mapping external_id="NFL-2023-PST" id="sr:season:102797"/>
<mapping external_id="NFL-2023-PRE" id="sr:season:105129"/>
Access
Please note that you will need access to the Global American Football API in your account to make use of these endpoints.
Odds
The Odds APIs include NFL odds data, and are based on the sr_id system, with IDs that look like: sr:competitor:4419 or sr:sport_event:50690883.
Make use of the Mapping Feeds within each Odds API should you need to link IDs between APIs. These feeds provide id and sr_id links for leagues (Competitions), teams (Competitors), players, and games (Sport Events).
<mapping external_id="64e90d00-9ea0-4c91-8292-e78414439d54" id="sr:competition:8"/>
<mapping external_id="ea97fe54-4712-4bd7-b643-8409887f9f61" id="sr:competition:16"/>
<mapping external_id="fdc32c0e-2a6a-4bbe-b855-41fef6369bfe" id="sr:competition:17"/>
<mapping external_id="cd24a25b-3fc0-48fd-9c54-f793d51af976" id="sr:competition:23"/>
<mapping external_id="3c6d318a-6164-4290-9bbc-bf9bb21cc4b8" id="sr:competition:31"/>
<mapping external_id="65da41c2-5231-42a1-acb9-7fe295b12fc7" id="sr:competitor:1"/>
<mapping external_id="eb9aa424-85af-443d-a7c1-8a8614637d8e" id="sr:competitor:2"/>
<mapping external_id="b1ef96b0-be25-48b6-b6c5-c4d876116110" id="sr:competitor:3"/>
<mapping external_id="2c669de5-7b24-46f2-8d2b-715784f8ac4d" id="sr:competitor:4"/>
<mapping external_id="b8c90280-978c-40fc-8cb8-35996992825f" id="sr:competitor:5"/>
<mapping external_id="036f914a-aad0-4ff1-9771-54f9e963d1b8" id="sr:player:996277"/>
<mapping external_id="252f4b13-6abb-45dc-ae85-f822b817cb51" id="sr:player:1605464"/>
<mapping external_id="31a50d54-ef46-47a8-863c-6f4d4e5aa184" id="sr:player:607928"/>
<mapping external_id="3f64e9a6-6e1e-499b-aec8-764c99f634b2" id="sr:player:857970"/>
<mapping external_id="51ee792b-20c1-4ce5-b123-53fa05cb943e" id="sr:player:922298"/>
<mapping external_id="5ca22b1c-3ede-4a91-bbe8-456179e8e230" id="sr:sport_event:50733635"/>
<mapping external_id="ab166a44-3adb-4195-ab29-ca60eb2ea7c8" id="sr:sport_event:50690883"/>
<mapping external_id="a75e6ddd-6570-4584-9323-9bb363f40cf3" id="sr:sport_event:50690877"/>
<mapping external_id="eee98b92-75b6-474e-a27f-43e562baeb2b" id="sr:sport_event:50690787"/>
<mapping external_id="dbfa2bd2-15c2-46a6-bfd4-75b8543a970a" id="sr:sport_event:50690785"/>
Access
Please note that you will need access to the Odds APIs in your account to make use of these endpoints.
Images & Editorial
Our Images and Editorial APIs include both UUID and SR IDs within image and article entries (under entity_id). This allows you to sync player, team, and game IDs to this content.
<asset id="12e64f04-09e4-4c45-9352-766a4fc52476" created="2023-07-29T18:48:49+00:00" updated="2023-08-07T21:47:00+00:00" player_id="bd1120b6-38b3-4225-a4b0-20660a149d0d" posed="true">
<title>
<![CDATA[T.J. Hockenson]]>
</title>
<description>
<![CDATA[This is a 2023 photo of TJ Hockenson of the Minnesota Vikings NFL football team. This image reflects the Minnesota Vikings active roster as of Wednesday, May 31, 2023 when this image was taken. (AP Photo)]]>
</description>
<copyright>Associated Press</copyright>
<links>
<link width="3000" height="2399" href="/headshots/players/12e64f04-09e4-4c45-9352-766a4fc52476/original.jpg"/>
<link width="300" height="240" href="/headshots/players/12e64f04-09e4-4c45-9352-766a4fc52476/300w-resize.jpg"/>
</links>
<refs>
<ref name="Hockenson, T.J." type="profile" sport="nfl" sportradar_id="bd1120b6-38b3-4225-a4b0-20660a149d0d" sportsdata_id="175e41ce-3a04-479d-9542-458c8e82180b" primary="true">
<entity_id origin="SR" id="sr:player:1225630" sport="nfl"/>
<entity_id origin="SD" id="bd1120b6-38b3-4225-a4b0-20660a149d0d" alt_id="175e41ce-3a04-479d-9542-458c8e82180b" sport="nfl"/>
</ref>
<ref name="Minnesota Vikings" type="organization" sport="nfl" sportradar_id="33405046-04ee-4058-a950-d606f8c30852" sportsdata_id="MIN">
<entity_id origin="SR" id="sr:competitor:4423" sport="nfl"/>
<entity_id origin="SD" id="33405046-04ee-4058-a950-d606f8c30852" alt_id="MIN" sport="nfl"/>
</ref>
</refs>
<provider name="ap">
<provider_item_id>18e3d3e2587842fa89f7623775ee1da5</provider_item_id>
<original_publish>2023-05-31T18:59:22+00:00</original_publish>
</provider>
</asset>
<asset id="8789a71c-0563-4ea3-9388-9c1b82205268" created="2024-02-12T05:10:13+00:00" updated="2024-02-12T05:10:17+00:00">
<title>
<![CDATA[APTOPIX Super Bowl Football]]>
</title>
<description>
<![CDATA[Kansas City Chiefs quarterback Patrick Mahomes (15) holds the Vince Lombardi Trophy after the NFL Super Bowl 58 football game against the San Francisco 49ers, Sunday, Feb. 11, 2024, in Las Vegas. The Chiefs won 25-22. (AP Photo/John Locher)]]>
</description>
<links>
<link width="1909" height="2864" href="/assets/2024/2/11/8789a71c-0563-4ea3-9388-9c1b82205268/original.jpg"/>
<link width="667" height="1000" href="/assets/2024/2/11/8789a71c-0563-4ea3-9388-9c1b82205268/h1000-max-resize.jpg"/>
</links>
<refs>
<ref name="Kansas City Chiefs" type="organization" sport="nfl" sportradar_id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" sportsdata_id="KC">
<entity_id origin="SR" id="sr:competitor:4422" sport="nfl"/>
<entity_id origin="SD" id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" alt_id="KC" sport="nfl"/>
</ref>
<ref name="Mahomes, Patrick" type="profile" sport="nfl" sportradar_id="11cad59d-90dd-449c-a839-dddaba4fe16c">
<entity_id origin="SR" id="sr:player:1129537" sport="nfl"/>
<entity_id origin="SD" id="11cad59d-90dd-449c-a839-dddaba4fe16c" sport="nfl"/>
</ref>
<ref name="SF at KC (NFL - 2023 PST Week 4 - 2/11/2024)" type="event" sport="nfl" sportradar_id="902a4753-72f9-4868-9d9b-193a5c41ea4d">
<entity_id origin="SR" id="sr:match:46791617" sport="nfl"/>
<entity_id origin="SD" id="902a4753-72f9-4868-9d9b-193a5c41ea4d" sport="nfl"/>
</ref>
<ref name="San Francisco 49ers" type="organization" sport="nfl" sportradar_id="f0e724b0-4cbf-495a-be47-013907608da9" sportsdata_id="SF">
<entity_id origin="SR" id="sr:competitor:4389" sport="nfl"/>
<entity_id origin="SD" id="f0e724b0-4cbf-495a-be47-013907608da9" alt_id="SF" sport="nfl"/>
</ref>
</refs>
</asset>
Widgets
Our NFL Widgets often will require the input of a unique game, team, player, or season ID. Each of these are the UUIDs found in the NFL API.
Game IDs
Each NFL game will have its own unique identifier under game.id. See below for a sample taken from the Season Schedule endpoint.
<game id="ebb5f3ac-bb13-4dc4-ab8b-6c65623eac13" status="scheduled" scheduled="2024-09-06T00:20:00+00:00" entry_mode="LDE" sr_id="sr:match:50075555" game_type="regular" conference_game="true">
<venue id="2ec4c411-dac2-403d-b091-6b6aa4a0a914" name="GEHA Field at Arrowhead Stadium" city="Kansas City" state="MO" country="USA" zip="64129" address="One Arrowhead Drive" capacity="76416" surface="turf" roof_type="outdoor" sr_id="sr:venue:8189">
<location lat="39.049019" lng="-94.484140"/>
</venue>
<home id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Kansas City Chiefs" alias="KC" game_number="1" sr_id="sr:competitor:4422"/>
<away id="ebd87119-b331-4469-9ea6-d51fe3ce2f1c" name="Baltimore Ravens" alias="BAL" game_number="1" sr_id="sr:competitor:4413"/>
<broadcast network="NBC"/>
</game>
"games": [
{
"id": "ebb5f3ac-bb13-4dc4-ab8b-6c65623eac13",
"status": "scheduled",
"scheduled": "2024-09-06T00:20:00+00:00",
"entry_mode": "LDE",
"sr_id": "sr:match:50075555",
"game_type": "regular",
"conference_game": true,
"venue": {
"id": "2ec4c411-dac2-403d-b091-6b6aa4a0a914",
"name": "GEHA Field at Arrowhead Stadium",
"city": "Kansas City",
"state": "MO",
"country": "USA",
"zip": "64129",
"address": "One Arrowhead Drive",
"capacity": 76416,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8189",
"location": {
"lat": "39.049019",
"lng": "-94.484140"
}
},
Once created, game IDs are unchanging, except in the rare case that a game is postponed, or a game is mistakenly created twice (the duplicated UUID would be removed).
Team IDs
Each NFL team will have its own unique identifier under team.id. You can locate all active teams in the League Hierarchy feed, and all active teams in our NFL database in the Teams feed.
<team id="de760528-1dc0-416a-a978-b510d20692ff" name="Cardinals" market="Arizona" alias="ARI" sr_id="sr:competitor:4412"/>
<team id="1f6dcffb-9823-43cd-9ff4-e7a8466749b5" name="Chargers" market="Los Angeles" alias="LAC" sr_id="sr:competitor:4429"/>
<team id="6680d28d-d4d2-49f6-aace-5292d3ec02c2" name="Chiefs" market="Kansas City" alias="KC" sr_id="sr:competitor:4422"/>
"id": "324decdd-aa1b-4074-8958-c009d8fac31a",
"name": "AFC West",
"alias": "AFC_WEST",
"teams": [
{
"id": "ce92bd47-93d5-4fe9-ada4-0fc681e6caa0",
"name": "Broncos",
"market": "Denver",
"alias": "DEN",
"sr_id": "sr:competitor:4418",
"founded": 1960,
"owner": "Walton-Penner Family Group",
"general_manager": "George Paton",
"president": "Damani Leech",
"mascot": "Miles",
"championships_won": 3,
"championship_seasons": "1997, 1998, 2015",
"conference_titles": 8,
"division_titles": 15,
"playoff_appearances": 22,
"venue": {
"id": "6589e61d-ef1e-4e30-91b5-9acd2072b8a0",
"name": "Empower Field at Mile High",
"city": "Denver",
"state": "CO",
"country": "USA",
"zip": "80204",
"address": "1701 Mile High Stadium Circle",
"capacity": 76125,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8179",
"location": {
"lat": "39.743865",
"lng": "-105.020158"
}
},
"franchise": {
"id": "32e2db10-be6d-41ed-9e3d-5b30ba164b99",
"name": "Broncos",
"alias": "DEN"
},
"team_colors": [
{
"type": "secondary",
"hex_color": "#002244",
"alpha": 0,
"rgb_color": {
"red": 0,
"green": 34,
"blue": 68
}
},
{
"type": "primary",
"hex_color": "#fb4f14",
"alpha": 0,
"rgb_color": {
"red": 251,
"green": 79,
"blue": 20
}
}
]
},
{
"id": "1f6dcffb-9823-43cd-9ff4-e7a8466749b5",
"name": "Chargers",
"market": "Los Angeles",
"alias": "LAC",
"sr_id": "sr:competitor:4429",
"founded": 1960,
"owner": "Spanos Family",
"general_manager": "Tom Telesco",
"president": "John Spanos",
"nicknames": "The Bolts",
"championships_won": 0,
"conference_titles": 1,
"division_titles": 10,
"playoff_appearances": 15,
"venue": {
"id": "790c1f04-73c6-4f6f-8b1e-78a62260be90",
"name": "SoFi Stadium",
"city": "Inglewood",
"state": "CA",
"country": "USA",
"zip": "90301",
"address": "1000 S Prairie Ave",
"capacity": 70240,
"surface": "artificial",
"roof_type": "outdoor",
"sr_id": "sr:venue:52183",
"location": {
"lat": "33.953536",
"lng": "-118.338734"
}
},
"franchise": {
"id": "a74d513a-dd7f-440d-a366-249f8f8dd97d",
"name": "Chargers",
"alias": "LAC"
},
"team_colors": [
{
"type": "primary",
"hex_color": "#002a5e",
"alpha": 0,
"rgb_color": {
"red": 0,
"green": 42,
"blue": 94
}
},
{
"type": "secondary",
"hex_color": "#ffc20e",
"alpha": 0,
"rgb_color": {
"red": 255,
"green": 194,
"blue": 14
}
}
]
},
Team Relocation
Team IDs will not change once created.
However, if a team relocates we will create a new team ID and tie it to a franchise ID (franchise.id). For the Las Vegas Raiders (formerly Oakland), their Las Vegas team ID is 7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576 and their Oakland team ID is 1c1cec48-6352-4556-b789-35304c1a6ae1, but both teams are linked to the 859f427c-5157-4b5a-90e4-066e83f46cc3 franchise ID.
<team id="7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576" name="Raiders" market="Las Vegas" alias="LV" sr_id="sr:competitor:4390" founded="1960" owner="Davis Family" general_manager="Dave Ziegler" president="Sandra Douglass Morgan" mascot="Raider Rusher" nicknames="Silver and Black" fight_song="The Autumn Wind" championships_won="3" championship_seasons="1976, 1980, 1983" conference_titles="4" division_titles="15" playoff_appearances="23">
<franchise id="859f427c-5157-4b5a-90e4-066e83f46cc3" name="Raiders" alias="LV"/>
TBD Teams
Within the Teams feed, you will find a TBD team. This unique ID can be used to populate game information when game matchups are not yet known. You can find more info on this process in the Playoffs integration scenario.
<team id="23ed0bf0-f058-11ee-9989-93cc4251593a" name="TBD" market="Team" alias="TBD"/>
Player IDs
Each NFL player will have their own unique identifier under player.id. You can locate all players on a given team in the Team Roster endpoint, and retrieve detailed player biographical info and stats in the Player Profile endpoint.
Player IDs will not change once created.
<team xmlns="http://feed.elasticstats.com/schema/football/team-v7.0.xsd" id="0d855753-ea21-4953-89f9-0e20aff9eb73" name="Saints" market="New Orleans" alias="NO" sr_id="sr:competitor:4425" founded="1967" owner="Gayle Benson" general_manager="Mickey Loomis" president="Dennis Lauscha" mascot="Gumbo, Sir Saint" nicknames="The Black and Gold" fight_song="When the Saints Go Marching In" championships_won="1" championship_seasons="2009" conference_titles="1" division_titles="9" playoff_appearances="14">
<franchise id="bdf043f4-8199-4f76-92ea-5604cc53ad12" name="Saints" alias="NO"/>
<venue id="3c85d89a-ec66-4983-acd5-1381d6c8673a" name="Caesars Superdome" city="New Orleans" state="LA" country="USA" zip="70112" address="1500 Sugar Bowl Drive" capacity="73208" surface="artificial" roof_type="dome" sr_id="sr:venue:8195">
<location lat="29.950928" lng="-90.080876"/>
</venue>
<hierarchy>
<division id="2a46bf95-b036-4c6c-b69f-a80c4b6c46bf" name="NFC South" alias="NFC_SOUTH"/>
<conference id="b1808e5f-d40b-47c0-8af8-5175c0fdcd26" name="NFC" alias="NFC"/>
</hierarchy>
<coaches>
<coach id="bbd8061a-cd3c-4ddb-b2ca-93d58fc40a9c" full_name="Klint Kubiak" first_name="Klint" last_name="Kubiak" position="Offensive Coordinator"/>
<coach id="c232fbca-e44b-4523-90eb-268e4bbb5d5f" full_name="Joe Woods" first_name="Joe" last_name="Woods" position="Defensive Coordinator"/>
<coach id="ef1b4704-0ce4-4977-a882-2b14413dd2d2" full_name="Dennis Allen" first_name="Dennis" last_name="Allen" position="Head Coach"/>
</coaches>
<players>
<player id="00ba8fa0-93ee-4e40-823a-d03a2639fce1" name="Jack Heflin" jersey="95" last_name="Heflin" first_name="Jack" abbr_name="J.Heflin" birth_date="1998-03-08" weight="304.0" height="75" position="DT" birth_place="Galesburg, IL, USA" high_school="Erie-Prophetstown (IL)" college="Iowa" college_conf="Big Ten Conference" rookie_year="2021" status="ACT" sr_id="sr:player:2197662" experience="2">
</player>
<player id="0226b03b-f91d-4223-9813-9fcd2e9c3acc" name="Juwan Johnson" jersey="83" last_name="Johnson" first_name="Juwan" abbr_name="J.Johnson" birth_date="1996-09-13" weight="231.0" height="76" position="TE" birth_place="Glassboro, NJ, USA" high_school="Glassboro (NJ)" college="Oregon" college_conf="Pacific Twelve Conference" rookie_year="2020" status="ACT" sr_id="sr:player:2040489" experience="5">
</player>
<player id="054cf859-2cf7-4621-a98e-b440e66508a5" name="Paulson Adebo" jersey="29" last_name="Adebo" first_name="Paulson" abbr_name="P.Adebo" birth_date="1999-07-03" weight="192.0" height="73" position="CB" birth_place="Farmington, MI, USA" high_school="Mansfield (TX)" college="Stanford" college_conf="Pacific Twelve Conference" rookie_year="2021" status="ACT" sr_id="sr:player:1236400" experience="4">
<draft year="2021" round="3" number="76">
<team id="0d855753-ea21-4953-89f9-0e20aff9eb73" name="Saints" market="New Orleans" alias="NO" sr_id="sr:competitor:4425"/>
</draft>
</player>
<player id="09bdc469-0d82-4bce-8d49-810a44a550da" name="Pete Werner" jersey="20" last_name="Werner" first_name="Pete" abbr_name="P.Werner" birth_date="1999-06-05" weight="242.0" height="75" position="LB" birth_place="Indianapolis, IN, USA" high_school="Cathedral (IN)" college="Ohio State" college_conf="Big Ten Conference" rookie_year="2021" status="ACT" sr_id="sr:player:2197674" experience="4">
<draft year="2021" round="2" number="60">
<team id="0d855753-ea21-4953-89f9-0e20aff9eb73" name="Saints" market="New Orleans" alias="NO" sr_id="sr:competitor:4425"/>
</draft>
</player>
<player id="0b97067d-9e06-4ec0-97b2-e1cb491e12a6" name="Equanimeous St. Brown" jersey="13" last_name="St. Brown" first_name="Equanimeous" abbr_name="E.St. Brown" birth_date="1996-09-30" weight="214.0" height="77" position="WR" birth_place="Anaheim, CA, USA" high_school="Servite (CA)" college="Notre Dame" college_conf="Independent" rookie_year="2018" status="ACT" sr_id="sr:player:1198884" experience="7">
<draft year="2018" round="6" number="207">
<team id="a20471b4-a8d9-40c7-95ad-90cc30e46932" name="Packers" market="Green Bay" alias="GB" sr_id="sr:competitor:4420"/>
</draft>
</player>
<player id="0cd46b5f-5397-4947-9331-8d3420af7852" name="Kendal Vickers" jersey="91" last_name="Vickers" first_name="Kendal" abbr_name="K.Vickers" birth_date="1995-05-23" weight="295.0" height="75" position="DT" birth_place="Havelock, NC, USA" high_school="Havelock (NC)" college="Tennessee" college_conf="Southeastern Conference" rookie_year="2018" status="ACT" sr_id="sr:player:1216304" experience="3">
</player>
{
"id": "11cad59d-90dd-449c-a839-dddaba4fe16c",
"name": "Patrick Mahomes",
"jersey": "15",
"last_name": "Mahomes",
"first_name": "Patrick",
"abbr_name": "P.Mahomes",
"birth_date": "1995-09-17",
"weight": 225,
"height": 74,
"position": "QB",
"birth_place": "Tyler, TX, USA",
"high_school": "Whitehouse (TX)",
"college": "Texas Tech",
"college_conf": "Big Twelve Conference",
"rookie_year": 2017,
"status": "ACT",
"sr_id": "sr:player:1129537",
"experience": 8,
"team": {
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"name": "Chiefs",
"market": "Kansas City",
"alias": "KC",
"sr_id": "sr:competitor:4422"
},
"draft": {
"year": 2017,
"round": 1,
"number": 10,
"team": {
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"name": "Chiefs",
"market": "Kansas City",
"alias": "KC",
"sr_id": "sr:competitor:4422"
}
},
"seasons": [
{
"id": "3d6abb6b-9c91-40a9-9441-bbadc8a56f0e",
"year": 2017,
"type": "PRE",
"name": "PRE",
"teams": [
{
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"name": "Chiefs",
"market": "Kansas City",
"alias": "KC",
"sr_id": "sr:competitor:4422",
"statistics": {
"games_played": 4,
"games_started": 1,
"rushing": {
"avg_yards": 5.5,
"attempts": 8,
"touchdowns": 0,
"yards": 44,
"longest": 14,
"longest_touchdown": 0,
"redzone_attempts": 3,
"tlost": 0,
"tlost_yards": 0,
"first_downs": 0,
"broken_tackles": 0,
"kneel_downs": 0,
"scrambles": 0,
"yards_after_contact": 0
},
"passing": {
"attempts": 54,
"completions": 34,
"cmp_pct": 62.963,
"yards": 390,
"avg_yards": 7.222,
"sacks": 2,
"sack_yards": 14,
"touchdowns": 4,
"longest": 53,
"interceptions": 0,
"rating": 109.3,
"longest_touchdown": 28,
"air_yards": 241,
"redzone_attempts": 6,
"gross_yards": 390,
"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": 376,
"batted_passes": 0,
"on_target_throws": 0
},
"fumbles": {
"fumbles": 2,
"lost_fumbles": 1,
"own_rec": 1,
"own_rec_yards": -8,
"opp_rec": 0,
"opp_rec_yards": 0,
"out_of_bounds": 0,
"forced_fumbles": 0,
"own_rec_tds": 0,
"opp_rec_tds": 0,
"ez_rec_tds": 0
},
"defense": {
"tackles": 0,
"assists": 0,
"combined": 0,
"sacks": 0,
"sack_yards": 0,
"interceptions": 0,
"passes_defended": 0,
"forced_fumbles": 0,
"fumble_recoveries": 0,
"qb_hits": 0,
"tloss": 0,
"tloss_yards": 0,
"safeties": 0,
"sp_tackles": 0,
"sp_assists": 0,
"sp_forced_fumbles": 0,
"sp_fumble_recoveries": 0,
"sp_blocks": 0,
"misc_tackles": 0,
"misc_assists": 0,
"misc_forced_fumbles": 0,
"misc_fumble_recoveries": 1,
"def_targets": 0,
"def_comps": 0,
"blitzes": 0,
"hurries": 0,
"knockdowns": 0,
"missed_tackles": 0,
"batted_passes": 0
}
}
}
]
},
Player IDs in other Products
Each NFL player.id is specific to the NFL API. IDs will not transfer to other football APIs. To learn more about linking IDs across API products visit this section.
Duplicate Player IDs
A duplicate player profile (and player.id) can be introduced by mistake. In these cases, we will mark the duplicate player with a status of DUP. All profiles marked as duplicates can be ignored, but they will remain in our database to limit confusion.
<player xmlns="http://feed.elasticstats.com/schema/football/profile-v7.0.xsd" id="19543687-5ec4-4594-8de6-a53d11d03c1f"
name="Jacob Tuioti-Mariner" jersey="0" last_name="Tuioti-Mariner" first_name="Jacob" abbr_name="J.Tuioti-Mariner"
weight="285.0" height="74" position="DT" birth_place="Corona, CA, USA" high_school="St. John Bosco (CA)"
college="UCLA" status="DUP" sr_id="sr:player:1192430"></player>
{
"id": "19543687-5ec4-4594-8de6-a53d11d03c1f",
"name": "Jacob Tuioti-Mariner",
"jersey": "0",
"last_name": "Tuioti-Mariner",
"first_name": "Jacob",
"abbr_name": "J.Tuioti-Mariner",
"weight": 285.0,
"height": 74,
"position": "DT",
"birth_place": "Corona, CA, USA",
"high_school": "St. John Bosco (CA)",
"college": "UCLA",
"status": "DUP",
"sr_id": "sr:player:1192430",
"seasons": [],
"_comment": "Generation started @ 2024-06-20 15:05:11 UTC ended @ 2024-06-20 15:05:11 UTC"
}
Access all Player IDs
Iterate through the past Seasonal Statistics feeds for each season and team to obtain all player IDs in the NFL API.
Alternately, request the Game Roster endpoint for every NFL game to capture every player who has appeared on a team roster.
Season IDs
Each NFL season will have its own unique identifier under season.id. Season types can be PRE (Preseason), REG (Regular season), or PST (Postseason). You can locate all historical seasons in the Seasons feed.
Season IDs will not change once created.
<season id="a538d200-e916-4272-aa07-b486094a1668" year="2023" start_date="2023-09-07" end_date="2024-01-07" status="closed">
<type code="REG"/>
</season>
<season id="26a608a0-dfc9-11ee-8f7c-27de425212d4" year="2024" start_date="2024-08-01" end_date="2024-08-25" status="scheduled">
<type code="PRE"/>
</season>
<season id="26a6a4e0-dfc9-11ee-8f7c-27de425212d4" year="2024" start_date="2025-01-11" end_date="2025-02-09" status="scheduled">
<type code="PST"/>
</season>
<season id="26a67dd0-dfc9-11ee-8f7c-27de425212d4" year="2024" start_date="2024-09-05" end_date="2025-01-05" status="scheduled">
<type code="REG"/>
{
"id": "75749c10-56c1-4ae0-9d1e-2689708debdf",
"year": 2022,
"start_date": "2022-09-06",
"end_date": "2023-01-08",
"status": "closed",
"type": {
"code": "REG"
}
},
{
"id": "e511e447-8eac-4f9b-8da3-45e9970c25e7",
"year": 2023,
"start_date": "2023-08-03",
"end_date": "2023-08-27",
"status": "closed",
"type": {
"code": "PRE"
}
},
{
"id": "736474f0-adc5-11ee-b174-6f0e0e094ae8",
"year": 2023,
"start_date": "2024-01-13",
"end_date": "2024-02-11",
"status": "closed",
"type": {
"code": "PST"
}
},
{
"id": "a538d200-e916-4272-aa07-b486094a1668",
"year": 2023,
"start_date": "2023-09-07",
"end_date": "2024-01-07",
"status": "closed",
"type": {
"code": "REG"
}
},
{
"id": "26a608a0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"start_date": "2024-08-01",
"end_date": "2024-08-25",
"status": "scheduled",
"type": {
"code": "PRE"
}
},
{
"id": "26a6a4e0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"start_date": "2025-01-11",
"end_date": "2025-02-09",
"status": "scheduled",
"type": {
"code": "PST"
}
},
{
"id": "26a67dd0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"start_date": "2024-09-05",
"end_date": "2025-01-05",
"status": "scheduled",
"type": {
"code": "REG"
}
}
Venue IDs
Each NFL venue will have its own unique identifier under venue.id. You can locate all active team venues in League Hierarchy, and each Game feed will include the venue ID for that matchup.
Venue IDs will not change once created.
<team id="1f6dcffb-9823-43cd-9ff4-e7a8466749b5" name="Chargers" market="Los Angeles" alias="LAC" sr_id="sr:competitor:4429" founded="1960" owner="Spanos Family" general_manager="Tom Telesco" president="John Spanos" nicknames="The Bolts" championships_won="0" conference_titles="1" division_titles="10" playoff_appearances="15">
<franchise id="a74d513a-dd7f-440d-a366-249f8f8dd97d" name="Chargers" alias="LAC"/>
<venue id="790c1f04-73c6-4f6f-8b1e-78a62260be90" name="SoFi Stadium" city="Inglewood" state="CA" country="USA" zip="90301" address="1000 S Prairie Ave" capacity="70240" surface="artificial" roof_type="outdoor" sr_id="sr:venue:52183">
<location lat="33.953536" lng="-118.338734"/>
</venue>
"id": "1f6dcffb-9823-43cd-9ff4-e7a8466749b5",
"name": "Chargers",
"market": "Los Angeles",
"alias": "LAC",
"sr_id": "sr:competitor:4429",
"founded": 1960,
"owner": "Spanos Family",
"general_manager": "Tom Telesco",
"president": "John Spanos",
"nicknames": "The Bolts",
"championships_won": 0,
"conference_titles": 1,
"division_titles": 10,
"playoff_appearances": 15,
"venue": {
"id": "790c1f04-73c6-4f6f-8b1e-78a62260be90",
"name": "SoFi Stadium",
"city": "Inglewood",
"state": "CA",
"country": "USA",
"zip": "90301",
"address": "1000 S Prairie Ave",
"capacity": 70240,
"surface": "artificial",
"roof_type": "outdoor",
"sr_id": "sr:venue:52183",
"location": {
"lat": "33.953536",
"lng": "-118.338734"
}
},
"franchise": {
"id": "a74d513a-dd7f-440d-a366-249f8f8dd97d",
"name": "Chargers",
"alias": "LAC"
},
The Sportradar IDs will be consistent across sports and leagues, where available. Meaning those venue IDs would be consistent across APIs.
Updated about 2 months ago