GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

NCAA APIs – Fifth-Year Eligibility Status

We've added support for fifth-year student athletes in each of our NCAA APIs (NCAA Football, NCAA Men's Basketball, NCAA Women's Basketball, NCAA Men's Hockey).

Beginning this season, the experience or eligibility field may return a value of 5th.

📋

Field name varies by API: NCAA Football uses the eligibility field, while NCAA Men's Basketball, NCAA Women's Basketball, and NCAA Men's Hockey use experience.

Fifth-year players will be added to these APIs over the coming weeks, as teams update their rosters. You may not see 5th values immediately.

Here are the valid player experience and eligibility values:

  • FR - Freshman
  • SO - Sophomore
  • JR - Junior
  • SR - Senior
  • 5th - Fifth-year student-athlete
  • GR - Graduate student

Benefit

Use this new player status to build more accurate and complete rosters and player profiles.


📋 Recommended Actions

  • Update your roster and profile parsing to accept 5th as a valid value in the experience field (or eligibility for NCAA Football).
  • Confirm you read the correct field per API: eligibility for NCAA Football, experience for NCAA Men's/Women's Basketball and NCAA Men's Hockey.
  • Add display handling for fifth-year student-athletes wherever you show player class or eligibility.
  • Expect 5th values to populate over the coming weeks as teams update their rosters.

☑️ Sample Requests:

curl --request GET \
     --url https://api.sportradar.com/ncaafb/trial/v7/en/teams/{team_id}/full_roster.json \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
FootballNCAA Football APIv7
BasketballNCAA Men's Basketballv8, v7, v4
BasketballNCAA Women's Basketball APIv8, v7, v3
HockeyNCAA Men's Hockey APIv3

🔁 Endpoints Affected

NCAA Football API

  • Game Roster
  • Player Profile
  • Team Roster

NCAA Men's Basketball API

  • Player Profile
  • Team Profile

NCAA Women's Basketball API

  • Player Profile
  • Team Profile

NCAA Men's Hockey

  • Team Profile

⚙️ Return Samples

<player id="09b420e0-9832-11ed-8d6d-afdc7fa870c6" name="Johnny Football" jersey="6" last_name="Football" first_name="Johnny" abbr_name="J.Football" weight="205.0" height="72" position="DB" birth_place="Rock Rapids, IA, USA" status="ACT" eligibility="5th">
</player>
<player id="178468d8-54ad-45ca-9b2d-dfadfd819345" status="ACT" full_name="Jane Basketball" first_name="Jane" last_name="Basketball" abbr_name="J.Basketball" height="73" position="F" primary_position="NA" jersey_number="23" experience="5th" birth_place="Johnston, IA, USA" updated="2025-07-16T16:50:36+00:00">
</player>