Rankings

Poll rankings for college basketball (NCAAB) and college football (NCAAF). NCAAB supports the AP and Coaches polls. NCAAF supports the CFP, AP, and Coaches polls. Rankings are refreshed weekly during the season.

League Rankings

GET/v1/leagues/:leagueId/rankings

Get current poll rankings for a college league.

Parameter	Type	Required	Description
leagueId	string	Yes	ncaa_basketball or ncaa_football
poll	string	No	Poll type. NCAAB: ap, coaches. NCAAF: cfp, ap, coaches. Defaults to ap.

Response

{
  "success": true,
  "data": {
    "leagueId": "ncaa_basketball",
    "pollType": "ap",
    "season": "2025-26",
    "fetchedAt": "2026-03-30T12:00:00.000Z",
    "rankings": [
      { "rank": 1,  "teamName": "Auburn",       "record": "25-6",  "points": 1512, "teamId": "ncaab-auburn" },
      { "rank": 2,  "teamName": "Duke",          "record": "27-4",  "points": 1450, "teamId": "ncaab-duke" },
      { "rank": 3,  "teamName": "Houston",       "record": "26-5",  "points": 1398, "teamId": "ncaab-houston" },
      { "rank": 25, "teamName": "Michigan St.",  "record": "22-9",  "points": 312,  "teamId": "ncaab-michigan-state" }
    ]
  }
}

Supported polls by league

ncaa_basketball — ap, coaches
ncaa_football — cfp, ap, coaches
teamId is the same team ID events carry in homeTeamId / awayTeamId, so a ranked team matches its games directly. It is null for a ranked team we do not track.
The points field reflects poll voting points. For CFP rankings, points are not published — the field is 0 and conference is populated instead.

Rankings History

GET/v1/leagues/:leagueId/rankings/history

Every distinct poll we have saved for the league, newest first. firstSeenAt is when we first saw the poll (the earliest it was known, never the provider's date), lastSeenAt the last time we saw it. History starts on 2026-10-20. 404 for a league with no polls, 400 for a poll the league does not have. 1 credit.

Parameter	Type	Required	Description
leagueId	string	Yes	ncaa_basketball or ncaa_football
poll	string	No	NCAAB: ap, coaches. NCAAF: cfp, ap, coaches. Defaults to ap.
season	string	No	Season label, such as '2025-26'

Response

{
  "success": true,
  "data": [
    {
      "season": "2026-27",
      "pollType": "ap",
      "firstSeenAt": "2026-10-20T13:35:22.578Z",
      "lastSeenAt": "2026-10-20T15:54:51.525Z",
      "rankings": [
        { "rank": 1, "teamName": "Miami", "record": "6-0", "points": 1697, "teamId": "ncaaf-miami" }
      ]
    }
  ],
  "meta": { "leagueId": "ncaa_football", "pollType": "ap", "count": 1, "historyStartsAt": "2026-10-20" }
}

NCAAF CFP Example

GET/v1/leagues/ncaa_football/rankings?poll=cfp

Fetch CFP playoff rankings for college football.

Response

{
  "success": true,
  "data": {
    "leagueId": "ncaa_football",
    "pollType": "cfp",
    "season": "2025",
    "fetchedAt": "2025-12-08T12:00:00.000Z",
    "rankings": [
      { "rank": 1,  "teamName": "Oregon",     "record": "13-0", "conference": "Big Ten",  "points": 0, "teamId": "ncaaf-oregon" },
      { "rank": 2,  "teamName": "Georgia",    "record": "12-1", "conference": "SEC",      "points": 0, "teamId": "ncaaf-georgia" },
      { "rank": 3,  "teamName": "Texas",      "record": "12-1", "conference": "SEC",      "points": 0, "teamId": "ncaaf-texas" },
      { "rank": 12, "teamName": "Clemson",    "record": "10-3", "conference": "ACC",      "points": 0, "teamId": "ncaaf-clemson" }
    ]
  }
}