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 (Transfer Portal)
In NCAA Football, players can switch schools by entering the NCAA Transfer Portal, even mid-season. Mid-season transfers make the player ineligible to play until the next season, while off-season transfers help players avoid losing playing time and maintain academic progress.
You can track these moves directly using the NCAAFB Transfer Portal endpoint, which provides a list of all players currently in the NCAA Transfer Portal. A player’s ID remains constant even after transferring, ensuring you can track their career across teams without losing data continuity.
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.
To connect player data across both APIs, you can reference their NCAA ID within player.reference(s)
in the Player Profile, Team Profile, or Team Roster NFL API endpoints. This allows for efficient linking of college and pro profiles for analysis, draft prep, and career stats.
<player xmlns="http://feed.elasticstats.com/schema/football/profile-v7.0.xsd" id="3069db07-aa43-4503-ab11-2ae5c0002721" name="Josh Allen" jersey="17" last_name="Allen" first_name="Josh" abbr_name="J.Allen" birth_date="1996-05-21" weight="237.0" height="77" position="QB" birth_place="Firebaugh, CA, USA" high_school="Firebaugh (CA)" college="Wyoming" college_conf="Mountain West Conference" rookie_year="2018" status="ACT" sr_id="sr:player:1208608" experience="8" salary="36335281">
<team id="768c92aa-75ff-4a43-bcc0-f2798c2e1724" name="Bills" market="Buffalo" alias="BUF" sr_id="sr:competitor:4376"/>
<reference source_id="8d8ecf36-6983-47ab-89ec-7ecf328bbc63" scope="NCAAFB" id_type="league_profile"/>
{
"id": "11cad59d-90dd-449c-a839-dddaba4fe16c",
"name": "Patrick Mahomes",
"jersey": "15",
"last_name": "Mahomes",
"first_name": "Patrick",
"abbr_name": "P.Mahomes",
"birth_date": "1995-09-17",
"weight": 225.0,
"height": 74,
"position": "QB",
"birth_place": "Tyler, TX, USA",
"high_school": "Whitehouse (TX)",
"college": "Texas Tech",
"college_conf": "Big Twelve Conference",
"rookie_year": 2017,
"status": "ACT",
"sr_id": "sr:player:1129537",
"experience": 9,
"salary": 28062269,
"team": {
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"name": "Chiefs",
"market": "Kansas City",
"alias": "KC",
"sr_id": "sr:competitor:4422"
},
"references": [
{
"source_id": "531fa6d3-9c8e-437b-8eca-8ca79bf12cc0",
"scope": "NCAAFB",
"id_type": "league_profile"
}
],
Players drafted from the NCAA 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.
NCAA API player IDs are also present in the NFL Draft feeds under source_id
.
<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>
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"/>
AccessPlease 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"/>
AccessPlease 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">
--snip--
<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 8 days ago