ID Handling
Intro to IDs
Our NCAAFB 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 NCAAFB 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="52dc23de-c6ba-4467-b964-a433658eded2" name="Razorbacks" market="Arkansas" alias="ARK"/>
Transferring Schools
In NCAA Football, players can switch schools by entering the NCAA transfer portal, even mid-season. Mid-season transfers mean the player won't be eligible to play until the next season. Transfers often occur in the off-season to avoid losing playing time and to maintain academic progress.
Although there isn't a direct endpoint to track transfers, you can stay up to date on player updates, including transfers, using the Daily Change Log feed. Note that a player’s ID will remain constant even if they transfer to a new team, ensuring continuity in tracking their career.
IDs in other SR Products
NFL
Many NCAA Football players go on to play in the NFL, and thus have profiles and IDs within the NFL API. However, these unique IDs do not transfer from NCAA Football 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 NCAAFB 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 NCAAFB 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 NCAAFB 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), 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="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 the UUIDs 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="fe5eece6-fdfa-439f-a8c8-3473afd68512" created="2023-10-25T19:09:23+00:00" updated="2023-11-07T18:31:32+00:00" player_id="95099dfb-6e83-4b06-9625-d440332cba81" posed="false">
<title>
<![CDATA[Johnny Hodges]]>
</title>
<description>
<![CDATA[NCAA Football: Player Headshots 2023]]>
</description>
<copyright>USA Today Sports Images</copyright>
<links>
<link width="1200" height="1200" href="/headshots/players/fe5eece6-fdfa-439f-a8c8-3473afd68512/original.jpg"/>
<link width="250" height="250" href="/headshots/players/fe5eece6-fdfa-439f-a8c8-3473afd68512/250w-resize.jpg"/>
</links>
<refs>
<ref name="Hodges, Johnny" type="profile" sport="ncaafb" sportradar_id="95099dfb-6e83-4b06-9625-d440332cba81" primary="true">
<entity_id origin="SD" id="95099dfb-6e83-4b06-9625-d440332cba81" sport="ncaafb"/>
</ref>
<ref name="TCU Horned Frogs" type="organization" sport="ncaafb" sportradar_id="a09e634d-39a8-4aa8-81a4-7337580a31f4">
<entity_id origin="SD" id="a09e634d-39a8-4aa8-81a4-7337580a31f4" sport="ncaafb"/>
</ref>
</refs>
<provider name="usat">
<provider_item_id>21725132</provider_item_id>
<original_publish>2023-10-24T18:57:55+00:00</original_publish>
</provider>
</asset>
<asset id="615dff5c-4093-49e6-bf46-5210c10d5519" created="2023-09-14T10:27:46+00:00" updated="2023-09-14T10:28:50+00:00">
<title>
<![CDATA[SMU Oklahoma Football]]>
</title>
<description>
<![CDATA[Oklahoma linebacker Danny Stutsman (28) celebrates during the second half of the team's NCAA college football game against SMU on Saturday, Sept. 9, 2023, in Norman, Okla. (AP Photo/Alonzo Adams)]]>
</description>
<links>
<link width="2790" height="1860" href="/assets/2023/9/9/615dff5c-4093-49e6-bf46-5210c10d5519/original.jpg"/>
<link width="1000" height="667" href="/assets/2023/9/9/615dff5c-4093-49e6-bf46-5210c10d5519/h1000-max-resize.jpg"/>
</links>
<refs>
<ref name="Oklahoma Sooners" type="organization" sport="ncaafb" sportradar_id="OKL">
<entity_id origin="SD" id="OKL" sport="ncaafb"/>
</ref>
<ref name="SMU at OKL (NCAAFB - 9/9/2023)" type="event" sport="ncaafb" sportradar_id="2bff863f-aa7f-4985-a4e9-324ea22cdb21">
<entity_id origin="SD" id="2bff863f-aa7f-4985-a4e9-324ea22cdb21" sport="ncaafb"/>
</ref>
<ref name="Southern Methodist Mustangs" type="organization" sport="ncaafb" sportradar_id="SMU">
<entity_id origin="SD" id="SMU" sport="ncaafb"/>
</ref>
<ref name="Stutsman, Danny" type="profile" sport="ncaafb" sportradar_id="9988c381-437c-4386-865d-4d3a82a44363">
<entity_id origin="SD" id="9988c381-437c-4386-865d-4d3a82a44363" sport="ncaafb"/>
</ref>
</refs>
</asset>
Widgets
Our NCAAFB Widgets often will require the input of a unique game, team, player, or season ID. Each of these are the SR IDs found in the NCAAFB API.
Game IDs
Each NCAAFB game will have its own unique identifier under game.id. See below for a sample taken from the Season Schedule endpoint.
<game id="a23db539-d639-4113-8fbb-7117ee8ab7a9" status="scheduled" scheduled="2024-08-24T19:30:00+00:00" entry_mode="LDE" coverage="extended_boxscore" sr_id="sr:match:50078615" game_type="regular" conference_game="false">
<venue id="dcfa24e5-a53e-4cae-92e6-d31497c5610b" name="Memorial Stadium (Stephenville, TX)" city="Stephenville" state="TX" country="USA" zip="76401" address="N Harbin Drive" capacity="10000" surface="turf" roof_type="outdoor">
<location lat="32.2151" lng="-98.2235"/>
</venue>
<home id="ed05b9d3-0086-49bb-9ea5-329ab0d0729b" name="Tarleton State Texans" alias="TSU" game_number="1"/>
<away id="efc41557-a738-43fa-9519-8fd0734923f9" name="McNeese Cowboys" alias="MCN" game_number="1"/>
<broadcast network="ESPN2" satellite="209"/>
<time_zones venue="US/Central" home="US/Central" away="US/Central"/>
</game>
{
"games": [
{
"id": "a23db539-d639-4113-8fbb-7117ee8ab7a9",
"status": "scheduled",
"scheduled": "2024-08-24T19:30:00+00:00",
"entry_mode": "LDE",
"coverage": "extended_boxscore",
"sr_id": "sr:match:50078615",
"game_type": "regular",
"conference_game": false,
"venue": {
"id": "dcfa24e5-a53e-4cae-92e6-d31497c5610b",
"name": "Memorial Stadium (Stephenville, TX)",
"city": "Stephenville",
"state": "TX",
"country": "USA",
"zip": "76401",
"address": "N Harbin Drive",
"capacity": 10000,
"surface": "turf",
"roof_type": "outdoor",
"location": {
"lat": "32.2151",
"lng": "-98.2235"
}
}
}
]
}
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 NCAA Football 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 NCAAFB database in the Teams feed.
<team id="30abfee7-57a7-4984-9a1c-55cb28970da3" name="49ers" market="Charlotte" alias="CHA"/>
<team id="f6f4a672-6368-45aa-98d0-3756da844114" name="Aggies" market="New Mexico State" alias="NMS"/>
<team id="e7268e7f-a453-4f46-b005-689d1d4966d4" name="Aggies" market="Utah State" alias="UTS"/>
{
"league": {
"id": "26c1246a-2fc3-4b7e-8999-1685d3ab4676",
"name": "NCAA Football",
"alias": "NCAAFB"
},
"divisions": [
{
"id": "0c37e018-9a60-44dd-88af-e28ce4a4184b",
"name": "Division II",
"alias": "D2",
"conferences": [
{
"id": "151998c5-80e4-466f-aafe-0c25eb62de75",
"name": "South Atlantic Conference",
"alias": "SAC",
"teams": [
{
"id": "bcacfbac-3ab1-4d80-b852-943fb58d4796",
"name": "Bears",
"market": "Lenoir-Rhyne",
"alias": "LRU",
"franchise": {
"id": "bcacfbac-3ab1-4d80-b852-943fb58d4796",
"name": "Bears"
}
},
{
"id": "0d55a067-6556-47ac-b720-fc534c93ffce",
"name": "Bulldogs",
"market": "Wingate",
"alias": "WGU",
"franchise": {
"id": "0d55a067-6556-47ac-b720-fc534c93ffce",
"name": "Bulldogs"
}
},
{
"id": "22739891-4203-4907-9b2c-2a416d007105",
"name": "Eagles",
"market": "Carson-Newman",
"alias": "CNU",
"franchise": {
"id": "22739891-4203-4907-9b2c-2a416d007105",
"name": "Eagles"
}
},
{
"id": "b8828f0f-d7bb-4e7e-a278-854f509838e1",
"name": "Highland Cavaliers",
"market": "Virginia-Wise",
"alias": "UVW",
"franchise": {
"id": "b8828f0f-d7bb-4e7e-a278-854f509838e1",
"name": "Highland Cavaliers"
}
},
{
"id": "e82960cb-8abc-4bee-9624-298bbb623941",
"name": "Indians",
"market": "Catawba",
"alias": "CATC",
"franchise": {
"id": "e82960cb-8abc-4bee-9624-298bbb623941",
"name": "Indians"
}
},
{
"id": "f870de05-89cf-48fc-9649-8cfa325f8f66",
"name": "Lions",
"market": "Mars Hill",
"alias": "MHC",
"franchise": {
"id": "f870de05-89cf-48fc-9649-8cfa325f8f66",
"name": "Lions"
}
},
{
"id": "88006ae0-74e0-4d9a-a447-7c7bc3275a42",
"name": "Pioneers",
"market": "Tusculum",
"alias": "TC",
"franchise": {
"id": "88006ae0-74e0-4d9a-a447-7c7bc3275a42",
"name": "Pioneers"
}
},
{
"id": "23efdc8b-f31b-4827-bc04-15cdd9edbe78",
"name": "Saints",
"market": "Limestone",
"alias": "LIC",
"venue": {
"id": "249112d0-3965-4f2f-a110-2e137de9f1e5",
"name": "The Reservation",
"city": "Gaffney",
"state": "SC",
"country": "USA",
"zip": "29340",
"address": "132 Administrative Drive",
"capacity": 8250,
"surface": "turf",
"roof_type": "outdoor",
"location": {
"lat": "35.0681",
"lng": "-81.6389"
}
},
"franchise": {
"id": "23efdc8b-f31b-4827-bc04-15cdd9edbe78",
"name": "Saints"
}
},
{
"id": "5bd3392e-c876-45c3-aa04-3c668d1bec85",
"name": "Wolves",
"market": "Newberry",
"alias": "NEWC",
"franchise": {
"id": "5bd3392e-c876-45c3-aa04-3c668d1bec85",
"name": "Wolves"
}
}
]
}
]
}
]
}
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.
<home name="Team TBD" alias="TBD" id="e7ce7680-f058-11ee-89df-6558e107cb95">
Player IDs
Each NCAAFB 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="19775492-f1eb-4bc5-9e15-078ebd689c0f" name="Crimson Tide" market="Alabama" alias="BAMA" founded="1820" mascot="Big Al" fight_song="Yea Alabama" championships_won="18" conference_titles="30" playoff_appearances="8">
<franchise id="19775492-f1eb-4bc5-9e15-078ebd689c0f" name="Crimson Tide"/>
<venue id="3e133141-8ce3-4e3f-a6c3-72d31f9f1401" name="Bryant-Denny Stadium" city="Tuscaloosa" state="AL" country="USA" zip="35401" address="920 Paul West Bryant Drive" capacity="101821" surface="turf" roof_type="outdoor" sr_id="sr:venue:21438">
<location lat="33.2083" lng="-87.5504"/>
</venue>
<hierarchy>
<division id="43d3cede-6b8f-4158-bc7f-c3c7365e5b32" name="I-A" alias="FBS"/>
<conference id="c7a491c8-d0f2-4ca1-9403-f82db4452dd1" name="Southeastern" alias="SEC"/>
</hierarchy>
<coaches>
<coach id="5c1a8421-6061-4372-b4e5-385c2d8b0dcf" full_name="Kalen DeBoer" first_name="Kalen" last_name="DeBoer" position="Head Coach"/>
</coaches>
<players>
<player id="007a8470-9c41-11ed-9b81-9b68194c9dc2" name="Kadyn Proctor" jersey="74" last_name="Proctor" first_name="Kadyn" abbr_name="K.Proctor" weight="369.0" height="79" position="OL" birth_place="Des Moines, IA, USA" status="ACT" eligibility="SO">
</player>
<player id="02ab5fa0-077f-11ed-8214-251cd78b157c" name="Cade Carruth" jersey="16" last_name="Carruth" first_name="Cade" abbr_name="C.Carruth" weight="195.0" height="73" position="QB" birth_place="Trussville, AL, USA" status="ACT" eligibility="JR">
</player>
<player id="04de02a0-9c62-11ed-833d-cd3ec90dc1db" name="Richard Young" jersey="9" last_name="Young" first_name="Richard" abbr_name="R.Young" weight="216.0" height="71" position="RB" birth_place="Lehigh Acres, FL, USA" status="ACT" eligibility="FR">
</player>
<player id="085a8ba0-f5b9-11ed-87d2-9d6189800720" name="Austin Mack" jersey="10" last_name="Mack" first_name="Austin" abbr_name="A.Mack" weight="236.0" height="78" position="QB" birth_place="Loomis, CA, USA" status="ACT" eligibility="FR">
</player>
<player id="09b25960-535a-11ef-9e27-6f1ad5865031" name="Wade Estess" jersey="67" last_name="Estess" first_name="Wade" abbr_name="W.Estess" weight="305.0" height="75" position="OL" birth_place="Madison, MS, USA" status="ACT" eligibility="FR">
</player>
<player id="0ad756f0-afff-11ee-8afe-79eb599093df" name="Zavier Mincey" jersey="12" last_name="Mincey" first_name="Zavier" abbr_name="Z.Mincey" weight="204.0" height="75" position="DB" birth_place="Daytona Beach, FL, USA" status="ACT" eligibility="FR">
</player>
<player id="0d26a580-affc-11ee-8afe-79eb599093df" name="Dre Kirkpatrick Jr." jersey="21" last_name="Kirkpatrick" first_name="Dre" abbr_name="D.Kirkpatrick" weight="210.0" height="71" position="DB" birth_place="Gadsden, AL, USA" status="ACT" eligibility="FR" name_suffix="Jr.">
</player>
<player id="0d8115d7-89c8-41b7-9f44-7b8dcdd405e8" name="Jaeden Roberts" jersey="77" last_name="Roberts" first_name="Jaeden" abbr_name="J.Roberts" weight="310.0" height="77" position="OL" birth_place="Houston, TX, USA" status="ACT" eligibility="JR">
</player>
<player id="0db88c00-0780-11ed-8214-251cd78b157c" name="Michael Lorino III" jersey="27" last_name="Lorino" first_name="Michael" abbr_name="M.Lorino" weight="185.0" height="72" position="RB" birth_place="Birmingham, AL, USA" status="ACT" eligibility="JR" name_suffix="III">
</player>
<player id="10d08770-8e8c-11ec-8d02-85ead82574a9" name="Jeremiah Alexander" jersey="35" last_name="Alexander" first_name="Jeremiah" abbr_name="J.Alexander" weight="232.0" height="74" position="LB" birth_place="Alabaster, AL, USA" status="ACT" eligibility="SO">
</player>
<player id="147d8fc0-9c60-11ed-833d-cd3ec90dc1db" name="Ty Lockwood" jersey="89" last_name="Lockwood" first_name="Ty" abbr_name="T.Lockwood" weight="239.0" height="77" position="TE" birth_place="Thompson's Station, TN, USA" status="ACT" eligibility="FR">
</player>
<player id="14b56410-affe-11ee-8afe-79eb599093df" name="Red Morgan" jersey="16" last_name="Morgan" first_name="Red" abbr_name="R.Morgan" weight="186.0" height="72" position="DB" birth_place="Phenix City, AL, USA" status="ACT" eligibility="FR">
</player>
<player id="176892a0-affd-11ee-8afe-79eb599093df" name="William Sanders" jersey="70" last_name="Sanders" first_name="William" abbr_name="W.Sanders" weight="309.0" height="75" position="OL" birth_place="Brookwood, AL, USA" status="ACT" eligibility="FR">
</player>
<player id="1b62f915-f878-4568-ba09-6009e7865984" name="Josh Cuevas" jersey="80" last_name="Cuevas" first_name="Josh" abbr_name="J.Cuevas" weight="251.0" height="75" position="TE" birth_place="Los Angeles, CA, USA" status="ACT" eligibility="JR">
</player>
<player id="1c4da230-36e3-11ee-9a89-3b8abc909f3c" name="Davis Peterson" jersey="62" last_name="Peterson" first_name="Davis" abbr_name="D.Peterson" weight="235.0" height="73" position="OL" birth_place="Birmingham, AL, USA" status="ACT" eligibility="SO">
</player>
<player id="266e9e2f-e611-4b3f-a6f0-3c8b043c597f" name="Kneeland Hibbett" jersey="48" last_name="Hibbett" first_name="Kneeland" abbr_name="K.Hibbett" weight="240.0" height="74" position="LS" birth_place="Florence, AL, USA" status="ACT" eligibility="SR">
</player>
<player id="2868ac70-9c62-11ed-833d-cd3ec90dc1db" name="Conor Talty" jersey="31" last_name="Talty" first_name="Conor" abbr_name="C.Talty" weight="198.0" height="73" position="K" birth_place="Chicago, IL, USA" status="ACT" eligibility="FR">
</player>
<player id="28c836b0-36e3-11ee-9a89-3b8abc909f3c" name="Mac Smith" jersey="64" last_name="Smith" first_name="Mac" abbr_name="M.Smith" weight="270.0" height="75" position="OL" birth_place="Birmingham, AL, USA" status="ACT" eligibility="SO">
</player>
<player id="28d48540-0783-11ed-b632-85df930e72fa" name="Chase Davis" jersey="46" last_name="Davis" first_name="Chase" abbr_name="C.Davis" weight="182.0" height="73" position="DB" birth_place="Tuscaloosa, AL, USA" status="ACT" eligibility="JR">
</player>
<player id="29eee3c0-36e0-11ee-9a89-3b8abc909f3c" name="Walter Sansing" jersey="27" last_name="Sansing" first_name="Walter" abbr_name="W.Sansing" weight="160.0" height="70" position="DB" birth_place="Homewood, AL, USA" status="ACT" eligibility="SO">
</player>
<player id="2b20b540-affb-11ee-a0bf-3bc996cbde5b" name="Quinton Reese" jersey="36" last_name="Reese" first_name="Quinton" abbr_name="Q.Reese" weight="221.0" height="72" position="LB" birth_place="Birmingham, AL, USA" status="ACT" eligibility="FR">
</player>
<player id="2b8a2d30-9c61-11ed-833d-cd3ec90dc1db" name="Jaren Hamilton" jersey="16" last_name="Hamilton" first_name="Jaren" abbr_name="J.Hamilton" weight="195.0" height="73" position="WR" birth_place="Gainesville, FL, USA" status="ACT" eligibility="FR">
</player>
<player id="2b8c5e6c-3861-458e-ac2c-bfa1a089ba9d" name="James Burnip" jersey="86" last_name="Burnip" first_name="James" abbr_name="J.Burnip" weight="236.0" height="78" position="P" birth_place="Mount Macedon,, AUS" status="ACT" eligibility="SR">
</player>
<player id="2eb64060-517a-11ee-9662-cb9bf5e1ef69" name="Miguel Camboia" jersey="82" last_name="Camboia" first_name="Miguel" abbr_name="M.Camboia" weight="190.0" height="73" position="WR" birth_place="Woodstock, ON, CAN" status="ACT" eligibility="SO">
</player>
<player id="2fdf97e0-9c51-11ed-9b81-9b68194c9dc2" name="Qua Russaw" jersey="4" last_name="Russaw" first_name="Qua" abbr_name="Q.Russaw" weight="251.0" height="74" position="LB" birth_place="Montgomery, AL, USA" status="ACT" eligibility="FR">
</player>
<player id="301e0b00-9c52-11ed-9b81-9b68194c9dc2" name="Dylan Lonergan" jersey="12" last_name="Lonergan" first_name="Dylan" abbr_name="D.Lonergan" weight="214.0" height="74" position="QB" birth_place="Snellville, GA, USA" status="ACT" eligibility="FR">
</player>
<player id="3087fff0-affd-11ee-8afe-79eb599093df" name="Bubba Hampton" jersey="21" last_name="Hampton" first_name="Bubba" abbr_name="B.Hampton" weight="194.0" height="70" position="WR" birth_place="Daingerfield, TX, USA" status="ACT" eligibility="FR">
</player>
<player id="31b2fb78-8efe-4fdc-a392-6463cbb19264" name="CJ Dippre" jersey="81" last_name="Dippre" first_name="CJ" abbr_name="C.Dippre" weight="262.0" height="77" position="TE" birth_place="Scranton, PA, USA" status="ACT" eligibility="SR">
</player>
<player id="33255e70-8e8e-11ec-8d02-85ead82574a9" name="Jehiem Oatis" jersey="10" last_name="Oatis" first_name="Jehiem" abbr_name="J.Oatis" weight="325.0" height="77" position="DL" birth_place="Columbia, MS, USA" status="ACT" eligibility="JR">
</player>
{
"id": "c795fe68-566f-4cab-9fbc-4a51e2b1d73f",
"name": "Jalen Milroe",
"jersey": "4",
"last_name": "Milroe",
"first_name": "Jalen",
"abbr_name": "J.Milroe",
"weight": 225,
"height": 74,
"position": "QB",
"birth_place": "Katy, TX, USA",
"status": "ACT",
"eligibility": "JR",
"team": {
"id": "19775492-f1eb-4bc5-9e15-078ebd689c0f",
"name": "Crimson Tide",
"market": "Alabama",
"alias": "BAMA"
},
"seasons": [
{
"id": "d1132b13-2c29-4e6d-9011-b627c7fd9a17",
"year": 2021,
"type": "REG",
"name": "REG",
"teams": [
{
"id": "19775492-f1eb-4bc5-9e15-078ebd689c0f",
"name": "Crimson Tide",
"market": "Alabama",
"alias": "BAMA",
"statistics": {
"games_played": 5,
"games_started": 0,
"rushing": {
"avg_yards": 3.8,
"attempts": 15,
"touchdowns": 0,
"yards": 57,
"longest": 15,
"longest_touchdown": 0,
"redzone_attempts": 2,
"tlost": 2,
"tlost_yards": -9,
"first_downs": 4
},
"passing": {
"attempts": 7,
"completions": 3,
"cmp_pct": 42.857,
"yards": 41,
"avg_yards": 5.857,
"sacks": 2,
"sack_yards": 9,
"touchdowns": 1,
"longest": 24,
"interceptions": 0,
"rating": 139.2,
"longest_touchdown": 24,
"air_yards": 0,
"redzone_attempts": 4,
"gross_yards": 41,
"first_downs": 2,
"int_touchdowns": 0
}
}
}
]
},
{
"id": "ff53e5e4-10ef-4842-a0b7-b489956fa07e",
"year": 2022,
"type": "REG",
"name": "REG",
"teams": [
{
"id": "19775492-f1eb-4bc5-9e15-078ebd689c0f",
"name": "Crimson Tide",
"market": "Alabama",
"alias": "BAMA",
"statistics": {
"games_played": 8,
"games_started": 1,
"rushing": {
"avg_yards": 8.484,
"attempts": 31,
"touchdowns": 1,
"yards": 263,
"longest": 77,
"longest_touchdown": 3,
"redzone_attempts": 4,
"tlost": 2,
"tlost_yards": -11,
"first_downs": 10
},
"passing": {
"attempts": 53,
"completions": 31,
"cmp_pct": 58.491,
"yards": 297,
"avg_yards": 5.604,
"sacks": 4,
"sack_yards": 25,
"touchdowns": 5,
"longest": 35,
"interceptions": 3,
"rating": 125.37,
"longest_touchdown": 35,
"air_yards": 5,
"redzone_attempts": 6,
"gross_yards": 297,
"first_downs": 18,
"int_touchdowns": 0
},
"fumbles": {
"fumbles": 4,
"lost_fumbles": 2,
"own_rec": 2,
"own_rec_yards": 0,
"opp_rec": 0,
"opp_rec_yards": 0,
"out_of_bounds": 0,
"forced_fumbles": 0,
"own_rec_tds": 0,
"opp_rec_tds": 0,
"ez_rec_tds": 0
}
}
}
]
},
{
"id": "f58c6dbf-9dfe-487e-8b0b-af66af887206",
"year": 2023,
"type": "REG",
"name": "REG",
"teams": [
{
"id": "19775492-f1eb-4bc5-9e15-078ebd689c0f",
"name": "Crimson Tide",
"market": "Alabama",
"alias": "BAMA",
"statistics": {
"games_played": 13,
"games_started": 13,
"rushing": {
"avg_yards": 3.298,
"attempts": 161,
"touchdowns": 12,
"yards": 531,
"longest": 53,
"longest_touchdown": 53,
"redzone_attempts": 28,
"tlost": 6,
"tlost_yards": -18,
"first_downs": 44
},
"penalties": {
"penalties": 2,
"yards": 10,
"first_downs": 0
},
"passing": {
"attempts": 284,
"completions": 187,
"cmp_pct": 65.845,
"yards": 2834,
"avg_yards": 9.979,
"sacks": 44,
"sack_yards": 328,
"touchdowns": 23,
"longest": 79,
"interceptions": 6,
"rating": 172.17,
"longest_touchdown": 79,
"air_yards": -1,
"redzone_attempts": 25,
"gross_yards": 2834,
"first_downs": 116,
"int_touchdowns": 0
},
"fumbles": {
"fumbles": 3,
"lost_fumbles": 2,
"own_rec": 6,
"own_rec_yards": 0,
"opp_rec": 0,
"opp_rec_yards": 0,
"out_of_bounds": 0,
"forced_fumbles": 0,
"own_rec_tds": 0,
"opp_rec_tds": 0,
"ez_rec_tds": 0
},
"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": 1,
"misc_assists": 0,
"misc_forced_fumbles": 0,
"misc_fumble_recoveries": 0
},
"conversions": {
"pass_attempts": 1,
"pass_successes": 1,
"rush_attempts": 0,
"rush_successes": 0,
"receive_attempts": 0,
"receive_successes": 0,
"defense_attempts": 0,
"defense_successes": 0
}
}
}
]
}
]
}
Player IDs in other Products
Each NCAA College Football player.id is specific to the NCAAFB 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 id="0e2da420-1f6a-11ed-8f4f-bb76c7ebc16b" name="Uilisoni Amone" jersey="99" last_name="Amone" first_name="Uilisoni" abbr_name="U.Amone" weight="300.0" height="73" position="DL" birth_place="El Cerrito, CA, USA" status="DUP" eligibility="GR">
</player>
{
"id": "0e2da420-1f6a-11ed-8f4f-bb76c7ebc16b",
"name": "Uilisoni Amone",
"jersey": "99",
"last_name": "Amone",
"first_name": "Uilisoni",
"abbr_name": "U.Amone",
"weight": 300,
"height": 73,
"position": "DL",
"birth_place": "El Cerrito, CA, USA",
"status": "DUP",
"eligibility": "GR"
},
Access all Player IDs
Iterate through the past Seasonal Statistics feeds for each season and team to obtain all player IDs in the NCAAFB API.
Alternately, request the Game Roster endpoint for every NCAAFB game to capture every player who has appeared on a team roster.
Season IDs
Each NCAA College Football season will have its own unique identifier under season.id. The only season type is REG in the NCAAFB API. You can locate all historical seasons in the Seasons feed.
Season IDs will not change once created.
<season id="17d91be7-4bd3-4407-80e2-eca205c9284a" year="2020" start_date="2020-08-29" end_date="2021-05-24" status="closed">
<type code="REG"/>
</season>
<season id="d1132b13-2c29-4e6d-9011-b627c7fd9a17" year="2021" start_date="2021-08-28" end_date="2022-01-24" status="closed">
<type code="REG"/>
</season>
<season id="ff53e5e4-10ef-4842-a0b7-b489956fa07e" year="2022" start_date="2022-08-27" end_date="2023-01-16" status="closed">
<type code="REG"/>
</season>
<season id="f58c6dbf-9dfe-487e-8b0b-af66af887206" year="2023" start_date="2023-08-26" end_date="2024-01-15" status="closed">
<type code="REG"/>
</season>
<season id="908fbc20-f5c7-11ee-a306-c311afc28263" year="2024" start_date="2024-08-24" end_date="2025-01-21" status="scheduled">
<type code="REG"/>
{
"seasons": [
{
"id": "17d91be7-4bd3-4407-80e2-eca205c9284a",
"year": 2020,
"start_date": "2020-08-29",
"end_date": "2021-05-24",
"status": "closed",
"type": {
"code": "REG"
}
},
{
"id": "d1132b13-2c29-4e6d-9011-b627c7fd9a17",
"year": 2021,
"start_date": "2021-08-28",
"end_date": "2022-01-24",
"status": "closed",
"type": {
"code": "REG"
}
},
{
"id": "ff53e5e4-10ef-4842-a0b7-b489956fa07e",
"year": 2022,
"start_date": "2022-08-27",
"end_date": "2023-01-16",
"status": "closed",
"type": {
"code": "REG"
}
},
{
"id": "f58c6dbf-9dfe-487e-8b0b-af66af887206",
"year": 2023,
"start_date": "2023-08-26",
"end_date": "2024-01-15",
"status": "closed",
"type": {
"code": "REG"
}
},
{
"id": "908fbc20-f5c7-11ee-a306-c311afc28263",
"year": 2024,
"start_date": "2024-08-24",
"end_date": "2025-01-21",
"status": "scheduled",
"type": {
"code": "REG"
}
}
]
}
Venue IDs
Each NCAA College Football venue will have its own unique identifier under venue.id. You can locate all active team venues in Team Roster, and each Game feed will include the venue ID for that matchup.
Venue IDs will not change once created.
<team id="23efdc8b-f31b-4827-bc04-15cdd9edbe78" name="Saints" market="Limestone" alias="LIC">
<franchise id="23efdc8b-f31b-4827-bc04-15cdd9edbe78" name="Saints"/>
<venue id="249112d0-3965-4f2f-a110-2e137de9f1e5" name="The Reservation" city="Gaffney" state="SC" country="USA" zip="29340" address="132 Administrative Drive" capacity="8250" surface="turf" roof_type="outdoor">
<location lat="35.0681" lng="-81.6389"/>
</venue>
{
"id": "23efdc8b-f31b-4827-bc04-15cdd9edbe78",
"name": "Saints",
"market": "Limestone",
"alias": "LIC",
"venue": {
"id": "249112d0-3965-4f2f-a110-2e137de9f1e5",
"name": "The Reservation",
"city": "Gaffney",
"state": "SC",
"country": "USA",
"zip": "29340",
"address": "132 Administrative Drive",
"capacity": 8250,
"surface": "turf",
"roof_type": "outdoor",
"location": {
"lat": "35.0681",
"lng": "-81.6389"
}
},
"franchise": {
"id": "23efdc8b-f31b-4827-bc04-15cdd9edbe78",
"name": "Saints"
}
},
The Sportradar IDs will be consistent across sports and leagues, where available. Meaning those venue IDs would be consistent across APIs.
Updated 3 months ago