Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Team Roster

NCAAFB Team Roster provides a complete roster of players for a given team.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 30 minutes

Data Updates: Updates in realtime as changes are made to rosters or player profiles

📘

Managing Rosters

Learn how to use the Team Roster to load and maintain full player rosters in our Rosters and Players integration scenario.


Data Points

Franchise
AttributeParent ElementTypeDescription
idfranchiseGUIDUnique ID of a school

ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1
namefranchiseStringTeam name

ex. Hawkeyes
League
AttributeParent ElementTypeDescription
aliasconferenceStringAlias of a conference

ex. BIG-TEN
idconferenceGUIDUnique ID of a conference

ex. cddff7c9-65e1-4fe0-b052-87fd4213fbfe
nameconferenceStringName of a conference

ex. Big Ten
aliasdivisionStringAlias of a division

ex. FBS (Football Bowl Subdivision)
iddivisionGUIDUnique ID of a division

ex. 43d3cede-6b8f-4158-bc7f-c3c7365e5b32
namedivisionStringName of a division

ex. I-A
Player
AttributeParent ElementTypeDescription
abbr_nameplayerStringAbbreviated name of a player

ex. S.Bennett
birth_placeplayerStringBirthplace of a player

ex. Blackshear, GA, USA
eligibilityplayerStringEligibility status of a player

FR (Freshman), SO (Sophomore), JR (Junior), SR (Senior), 5th (Fifth-year student-athlete) GR (Graduate student)
first_nameplayerStringFirst name of a player

ex. Stetson
heightplayerIntegerHeight in inches
idplayerGUIDUnique ID of a player

ex. 4be48c57-4b7c-46ad-8535-445c195feda6
jerseyplayerStringJersey number of a player
last_nameplayerStringLast name of a player

ex. Bennet
nameplayerStringFull name of a player

ex. Stetson Bennet
name_suffixplayerStringSuffix of a player

ex. Jr.
positionplayerStringPosition of a player

See our FAQ for a list of valid positions
statusplayerStringStatus of a player

ACT (Active), DUP (Duplicate Player Profile), EXE (Exempt), NWT (Not with Team), PRA (Practice Squad), SUS (Suspended), TP (Transfer Portal)
weightplayerDecimalWeight in lbs
Coaches
AttributeParent ElementTypeDescription
first_namecoachStringFirst name of a coach

ex. Kirby
full_namecoachStringFull name of a coach

ex. Kirby Smart
idcoachGUIDUnique ID of a coach

ex. 9c34ca07-cd05-48dc-ba4e-45b9df6078eb
last_namecoachStringLast name of a coach

ex. Smart
name_suffixcoachStringSuffix of a coach

ex. Jr.
positioncoachStringType of coach

ex. Head Coach or Offensive Coordinator
Team
AttributeParent ElementTypeDescription
aliasteamStringTeam alias

ex. IOW (University of Iowa)
championships_wonteamIntegerNumber of championships won
conference_titlesteamIntegerNumber of conference titles
division_titlesteamIntegerNumber of division titles
fight_songteamStringTeam fight song

ex. Iowa Fight Song
foundedteamIntegerYear a school was founded
idteamGUIDUnique ID of a team

ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1
marketteamStringTeam market name

ex. Iowa
mascotteamStringTeam mascot

ex. Herky the Hawk
nameteamStringTeam name

ex. Hawkeyes
nicknamesteamStringTeam nicknames
playoff_appearancesteamIntegerNumber of College Football Playoff appearances
subdivisionteamStringTeam's subdivision within a conference

ex. BIG-TEN-WEST
hex_colorteam_colorStringTeam color HEX value

ex. #ffc62f
typeteam_colorStringType of team color

primary,secondary
redteam_color - rgb-colorIntegerTeam RGB color code - Red

ex. 255
greenteam_color - rgb-colorIntegerTeam RGB color code - Green

ex. 198
blueteam_color - rgb-colorIntegerTeam RGB color code - Blue

ex. 47
Venue
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue

ex. 886 Stadium Drive
capacityvenueIntegerCapacity of a venue

ex. 69250
cityvenueStringCity of a venue

ex. Iowa City
countryvenueStringCountry of a venue

ex. USA
idvenueGUIDUnique ID of a venue

ex. 967ef86b-d0de-49b7-8984-61f95104d30d
latvenue - locationDecimalLatitude of a venue

ex. 41.6587
lngvenue - locationDecimalLongitude of a venue

ex. -91.5511
namevenueStringName of a venue

ex. Kinnick Stadium
roof_typevenueStringRoof type of a venue

outdoor, dome, retractable_dome
statevenueStringState of a venue

ex. IA
surfacevenueStringSurface type of a venue

turf, artificial, outdoor
zipvenueIntegerZIP code of a venue

ex. 52242
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
required
Defaults to 19775492-f1eb-4bc5-9e15-078ebd689c0f

Unique Id of a team

Example: 19775492-f1eb-4bc5-9e15-078ebd689c0f

Note: This endpoint is designed for team_ids which exist in the current League Hierarchy endpoint

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json