College Football API

Realtime Sports API serves College Football (NCAA FBS) games through the same REST endpoints and JSON schema as every other league, using sport=football and league=college-football. You get the current scoreboard, live scores, game detail, play-by-play, teams, rosters and news, plus current odds and line history from a single source book. The /rankings endpoint adds the AP Top 25 and coaches polls and the College Football Playoff rankings, latest or any past week. Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA.

Slugs
sport=football
league=college-football
Teams
818
Season (from data)
2026 Regular Season
In the scoreboard now
20 games, 20 live

Upcoming and live College Football games

College Football games from the API
DateAwayHomeTime / ResultTVVenue
Sat, Nov 21North Carolina Tar HeelsatVirginia Cavaliers18 - 41 0:35 - 4th QuarterTV: CWScott Stadium · Charlottesville, VA
Sat, Nov 21Tennessee Tech Golden EaglesatMississippi State Bulldogs10 - 34 10:59 - 4th QuarterTV: SECN+Davis Wade Stadium · Starkville, MS
Sat, Nov 21#20Houston CougarsatWest Virginia Mountaineers24 - 31 10:00 - 4th QuarterTV: TNTMilan Puskar Stadium · Morgantown, WV
Sat, Nov 21Western Kentucky HilltoppersatLiberty Flames7 - 38 8:42 - 4th QuarterTV: ESPN+Williams Stadium (VA) · Lynchburg, VA
Sat, Nov 21Chattanooga Mocsat#3Alabama Crimson Tide0 - 33 HalftimeTV: SECN+Bryant-Denny Stadium · Tuscaloosa, AL
Sat, Nov 21Charlotte 49ersatTulsa Golden Hurricane7 - 7 HalftimeTV: ESPN+H. A. Chapman Stadium · Tulsa, OK
Sat, Nov 21Missouri State BearsatJacksonville State Gamecocks13 - 3 HalftimeTV: ESPN+AmFirst Stadium · Jacksonville, AL
Sat, Nov 21Middle Tennessee Blue RaidersatSam Houston Bearkats21 - 14 HalftimeTV: ESPN+Elliott T. Bowers Stadium · Huntsville, TX

From the /events endpoint for this league, refreshed every few minutes. Times are US Eastern. Full College Football schedule · College Football team APIs · Free College Football scoreboard widget

Live example

Request

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/college-football/events?limit=1"

Response captured from live data at 2026-11-21 20:49 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key.

Response

{
  "success": true,
  "data": [
    {
      "id": "401858305",
      "uid": "s:20~l:23~e:401858305",
      "name": "North Carolina Tar Heels at Virginia Cavaliers",
      "shortName": "UNC @ UVA",
      "date": "2026-11-21T17:30Z",
      "status": {
        "state": "in",
        "completed": false,
        "period": 4,
        "clock": "0:35",
        "detail": "0:35 - 4th Quarter",
        "halftime": false,
        "firstHalfEnded": true
      },
      "homeTeam": {
        "id": "258",
        "name": "Virginia Cavaliers",
        "abbreviation": "UVA",
        "logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0CWxFaV1xZTB9cXBQGX10",
        "color": "232d4b",
        "alternateColor": "f84c1e",
        "winner": false,
        "score": 41
      },
      "awayTeam": {
        "id": "153",
        "name": "North Carolina Tar Heels",
        "abbreviation": "UNC",
        "logo": "https://realtimesportsapi.com/api/images/proxy?id=GgcVSgNPTUMITUgaFFQVVVQXBVwOHV5LRQBZD1lbBllDXR0CWxFaV1xZTBxcVxQGX10",
        "color": "7bafd4",
        "alternateColor": "13294b",
        "winner": false,
        "score": 18
      },
      "competition": {
        "attendance": 0,
        "neutralSite": false,
        "conferenceCompetition": true,
        "divisionCompetition": true,
        "playByPlayAvailable": true,
        "highlightsAvailable": true
      },
      "venue": {
        "id": "3923",
        "name": "Scott Stadium",
        "city": "Charlottesville",
        "state": "VA",
        "indoor": false,
        "grass": false
      },
      "notes": [],
      "season": {
        "year": 2026,
        "displayName": "2026",
        "type": {
          "id": "2",
          "name": "Regular Season",
          "abbreviation": "reg"
        },
        "week": {
          "number": 12,
          "startDate": "2026-11-16T08:00Z",
          "endDate": "2026-11-23T07:59Z",
          "text": "Week 12"
        }
      },
      "broadcasts": [
        {
          "network": "CW",
          "type": "TV"
        }
      ],
      "officials": []
    }
  ],
  "meta": {
    "rateLimit": {
      "limit": 125,
      "remaining": 124,
      "reset": 1796083200000
    }
  }
}

College Football play-by-play example

Request

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/college-football/events/401858305/plays?limit=3"

Response captured from live data at 2026-11-21 20:49 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Plays from North Carolina Tar Heels at Virginia Cavaliers.

Response

{
  "success": true,
  "data": [
    {
      "id": "4018583053",
      "sequenceNumber": "1",
      "text": "(15:00) #92 A.Burrell kickoff 65 yards to the UVA00, Touchback",
      "shortText": "A. Burrell kickoff for 65 yds for a touchback",
      "alternativeText": "(15:00) #92 A.Burrell kickoff 65 yards to the UVA00, Touchback",
      "type": {
        "id": "53",
        "text": "Kickoff",
        "abbreviation": "K"
      },
      "period": 1,
      "clock": {
        "value": 900,
        "displayValue": "15:00"
      },
      "wallClock": "2026-11-21T17:39:52Z",
      "homeScore": 0,
      "awayScore": 0,
      "scoringPlay": false,
      "scoreValue": 0,
      "situation": {
        "down": 1,
        "distance": 10,
        "yardLine": 65,
        "yardsToEndzone": 65
      },
      "endSituation": {
        "down": 1,
        "distance": 10,
        "yardLine": 25,
        "yardsToEndzone": 75
      },
      "yardsGained": 0,
      "athletes": [
        {
          "id": "5139524",
          "name": "Aeron Burrell",
          "displayName": "Aeron Burrell",
          "shortName": "A. Burrell",
          "position": "PK",
          "team": {
            "id": "153"
          },
          "role": "kicker",
          "type": "kicker",
          "order": 1
        }
      ],
      "priority": false,
      "modified": "2026-11-21T17:41Z"
    },
    {
      "id": "40185830512",
      "sequenceNumber": "2",
      "text": "(14:59) Shotgun #7 B.Pribula rush middle for 3 yards gain to the UVA28 (#90 X.Lewis)",
      "shortText": "B. Pribula run for 3 yds",
      "alternativeText": "(14:59) Shotgun #7 B.Pribula rush middle for 3 yards gain to the UVA28 (#90 X.Lewis)",
      "type": {
        "id": "5",
        "text": "Rush",
        "abbreviation": "RUSH"
      },
      "period": 1,
      "clock": {
        "value": 895,
        "displayValue": "14:55"
      },
      "wallClock": "2026-11-21T17:42:06Z",
      "homeScore": 0,
      "awayScore": 0,
      "scoringPlay": false,
      "scoreValue": 0,
      "situation": {
        "down": 1,
        "distance": 10,
        "yardLine": 25,
        "yardsToEndzone": 75,
        "downDistanceText": "1st & 10 at UVA 25",
        "possessionText": "UVA 25"
      },
      "endSituation": {
        "down": 2,
        "distance": 7,
        "yardLine": 28,
        "yardsToEndzone": 72
      },
      "yardsGained": 3,
      "athletes": [
        {
          "id": "4685696",
          "name": "Beau Pribula",
          "displayName": "Beau Pribula",
          "shortName": "B. Pribula",
          "position": "QB",
          "team": {
            "id": "258"
          },
          "role": "rusher",
          "type": "rusher",
          "order": 1
        },
        {
          "id": "5294564",
          "name": "Xavier Lewis",
          "displayName": "Xavier Lewis",
          "shortName": "X. Lewis",
          "position": "DL",
          "team": {
            "id": "153"
          },
          "role": "tackler",
          "type": "tackler",
          "order": 2
        }
      ],
      "priority": false,
      "modified": "2026-11-21T17:42Z"
    },
    {
      "id": "40185830516",
      "sequenceNumber": "3",
      "text": "(14:37) Shotgun #10 E.Holstein rush left for 1 yard gain to the UVA29 fumbled by #10 E.Holstein at recovered by UVA #10 E.Holstein at UVA26 (#16 C.Bryson)",
      "shortText": "E. Holstein run for 1 yd, E. Holstein fumbled, recovered by E. Holstein, E. Holstein returned",
      "alternativeText": "(14:37) Shotgun #10 E.Holstein rush left for 1 yard gain to the UVA29 fumbled by #10 E.Holstein at recovered by UVA #10 E.Holstein at UVA26 (#16 C.Bryson)",
      "type": {
        "id": "9",
        "text": "Fumble Recovery (Own)"
      },
      "period": 1,
      "clock": {
        "value": 858,
        "displayValue": "14:18"
      },
      "wallClock": "2026-11-21T17:42:51Z",
      "homeScore": 0,
      "awayScore": 0,
      "scoringPlay": false,
      "scoreValue": 0,
      "situation": {
        "down": 2,
        "distance": 7,
        "yardLine": 28,
        "yardsToEndzone": 72,
        "downDistanceText": "2nd & 7 at UVA 28",
        "possessionText": "UVA 28"
      },
      "endSituation": {
        "down": 3,
        "distance": 6,
        "yardLine": 29,
        "yardsToEndzone": 71
      },
      "yardsGained": 1,
      "athletes": [
        {
          "id": "4870819",
          "name": "Eli Holstein",
          "displayName": "Eli Holstein",
          "shortName": "E. Holstein",
          "position": "QB",
          "team": {
            "id": "258"
          },
          "role": "rusher",
          "type": "rusher",
          "order": 1
        },
        {
          "id": "4870819",
          "name": "Eli Holstein",
          "displayName": "Eli Holstein",
          "shortName": "E. Holstein",
          "position": "QB",
          "team": {
            "id": "258"
          },
          "role": "recoverer",
          "type": "recoverer",
          "order": 2
        },
        {
          "id": "4870819",
          "name": "Eli Holstein",
          "displayName": "Eli Holstein",
          "shortName": "E. Holstein",
          "position": "QB",
          "team": {
            "id": "258"
          },
          "role": "fumbler",
          "type": "fumbler",
          "order": 3
        },
        "... 1 more"
      ],
      "priority": false,
      "modified": "2026-11-21T17:43Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 3,
      "total": 191,
      "totalPages": 64,
      "hasNextPage": true,
      "hasPreviousPage": false
    },
    "rateLimit": {
      "limit": 125,
      "remaining": 124,
      "reset": 1796083200000
    }
  }
}

Play-by-play API reference · Paid plans can receive each play as it happens over WebSocket or webhooks instead of polling.

College Football box score example

Request

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/college-football/events/401858305/boxscore"

Response captured from live data at 2026-11-21 20:49 UTC (refreshed every few minutes). Long arrays are trimmed; meta.rateLimit values are illustrative for a Free key. Box score for North Carolina Tar Heels at Virginia Cavaliers; player lists trimmed to 2 of 34 (home) and 35 (away).

Response

{
  "success": true,
  "data": {
    "homeTeam": {
      "id": "258",
      "name": "Virginia Cavaliers",
      "abbreviation": "UVA",
      "score": 41
    },
    "awayTeam": {
      "id": "153",
      "name": "North Carolina Tar Heels",
      "abbreviation": "UNC",
      "score": 18
    },
    "homePlayers": [
      {
        "id": "4685696",
        "name": "Beau Pribula",
        "jersey": "7",
        "categories": {
          "passing": {
            "completions/passingAttempts": "19/24",
            "passingYards": "297",
            "yardsPerPassAttempt": "12.4",
            "passingTouchdowns": "4",
            "interceptions": "0"
          },
          "rushing": {
            "rushingAttempts": "9",
            "rushingYards": "23",
            "yardsPerRushAttempt": "2.6",
            "rushingTouchdowns": "0",
            "longRushing": "15"
          }
        }
      },
      {
        "id": "4873442",
        "name": "Xavier Brown",
        "jersey": "0",
        "categories": {
          "rushing": {
            "rushingAttempts": "13",
            "rushingYards": "83",
            "yardsPerRushAttempt": "6.4",
            "rushingTouchdowns": "0",
            "longRushing": "29"
          },
          "receiving": {
            "receptions": "2",
            "receivingYards": "39",
            "yardsPerReception": "19.5",
            "receivingTouchdowns": "1",
            "longReception": "24"
          }
        }
      }
    ],
    "awayPlayers": [
      {
        "id": "5199937",
        "name": "Travis Burgess",
        "jersey": "3",
        "categories": {
          "passing": {
            "completions/passingAttempts": "23/42",
            "passingYards": "288",
            "yardsPerPassAttempt": "6.9",
            "passingTouchdowns": "1",
            "interceptions": "2"
          },
          "rushing": {
            "rushingAttempts": "12",
            "rushingYards": "101",
            "yardsPerRushAttempt": "8.4",
            "rushingTouchdowns": "0",
            "longRushing": "26"
          }
        }
      },
      {
        "id": "-7741",
        "name": " Team",
        "categories": {
          "passing": {
            "completions/passingAttempts": "0/1",
            "passingYards": "0",
            "yardsPerPassAttempt": "0.0",
            "passingTouchdowns": "0",
            "interceptions": "0"
          }
        }
      }
    ],
    "periodScores": {
      "home": [
        7,
        13,
        7,
        "... 1 more"
      ],
      "away": [
        0,
        10,
        0,
        "... 1 more"
      ]
    }
  },
  "meta": {
    "rateLimit": {
      "limit": 125,
      "remaining": 124,
      "reset": 1796083200000
    }
  }
}

Box score API reference

Build with the College Football API

College Football endpoints

Checked against live data on 2026-10-04. Paths are relative to /api/v1/sports/football/leagues/college-football.

EndpointPathCollege FootballNotes
Live scores/events/liveAvailable
Events (scoreboard)/eventsAvailable
Event detail/events/{eventId}Available
Play-by-play/events/{eventId}/playsAvailable
Box score/events/{eventId}/boxscoreAvailable
Odds/events/{eventId}/oddsAvailable
Win probability/events/{eventId}/winprobabilityAvailable
Teams/teamsAvailable
Rosters/teams/{teamId}/rosterAvailable
Athletes/athletes/searchAvailable
Injuries/injuriesLimitedOnly a handful of records are published for college football.
News/newsAvailable
Schedule / weeks/seasons/{season}/scheduleAvailable
NCAA tournament/seasons/{season}/tournamentNot available
Rankings/rankingsAvailable
Webhooks/webhooksAvailable
WebSocket/websocket/authAvailable
  • Week-based season: list weeks with /seasons/{season}/weeks and fetch one week with /seasons/{season}/schedule?week=N (College Football and the other football league only).
  • The teams endpoint lists 800+ teams across all divisions; use /seasons/{season}/types/2/groups/80/teams for FBS only.
  • Only a handful of records are published for college football.

Every College Football game in the events, live and schedule endpoints uses the same Event object as other leagues: Event object field reference.

College Football API in Python, JavaScript and curl

curl

curl -H "Authorization: Bearer $RSA_API_KEY" \
  "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/college-football/events?limit=5"

JavaScript (fetch)

const res = await fetch("https://www.realtimesportsapi.com/api/v1/sports/football/leagues/college-football/events?limit=5", {
  headers: { Authorization: `Bearer ${process.env.RSA_API_KEY}` }
});
const { success, data, meta } = await res.json();
console.log(data, meta.rateLimit);

Python (requests)

import os, requests

res = requests.get(
    "https://www.realtimesportsapi.com/api/v1/sports/football/leagues/college-football/events?limit=5",
    headers={"Authorization": f"Bearer {os.environ['RSA_API_KEY']}"},
    timeout=10,
)
body = res.json()
print(body["data"])

MCP prompt (Claude, Cursor, ChatGPT)

Using the Realtime Sports MCP server (https://www.realtimesportsapi.com/api/mcp), call get_events with sport "football" and league "college-football" and list the games it returns with start times, status and scores for College Football.

Connect the hosted MCP server first: setup guide. Each tool call counts as one API call.

Each request above is 1 call. Free covers 125 calls a month after a 1,000-call first month, at 1 request/second. Starter is $29/month for 10,000 calls (about 333 a day) plus webhooks and WebSocket, so you stop polling for changes; 7-day free trial. Compare plans

Real-time College Football push: WebSocket and webhooks

Instead of polling, paid plans can receive every College Football game start, score change and final as it is detected (typically 20-30 seconds behind live play): a College Football WebSocket feed for live dashboards and apps, or College Football webhooks that POST each event to your server. On the Free plan you can watch the stream and send yourself a sample webhook from the dashboard.

Shipping a product with College Football data?

Polling works on every plan. Production apps usually also want events pushed to them, by webhook or WebSocket, as soon as we detect them (typically 20-30 seconds behind live play). These guides show the setup and the plan each one needs.

College Football API pricing and rate limits

The College Football API is included in every plan, Free included: one key covers all leagues. Free starts with 1,000 calls in your first 30 days (no card); paid plans start at $29/month with a 7-day free trial.

PlanPriceCallsRateWebSocketWebhooks
Free$0125/mo (1,000 first 30 days)1/s500 msgs/moNo
Starter$29/mo ($290/yr)10,000/mo5/sShares monthly poolShares monthly pool
Growth$49/mo ($490/yr)25,000/mo10/sShares monthly poolShares monthly pool
Pro$99/mo ($990/yr)50,000/mo20/s100,000 msgs/mo25,000/mo
Business$179/mo ($1,790/yr)150,000/mo40/s300,000 msgs/mo75,000/mo
Scale$299/mo ($2,990/yr)500,000/mo100/s500,000 msgs/mo100,000/mo

Every successful REST call counts as one call. Over the limit you get HTTP 429 with a Retry-After header. No SLA. Full pricing.

29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.

FAQ

Is there a free College Football API?
Yes. The Free plan is $0 with 125 calls per month (1,000 in the first 30 days) at 1 request per second, no card required. The same key works for all 29 leagues.
How fresh is the College Football data?
Data is aggregated from public sources and is typically 20-30 seconds behind live play (about 1 second after our source). There is no SLA. It is not intended for in-play betting that needs sub-second data.
Which College Football endpoints are available?
Available: live scores, events (scoreboard), event detail, play-by-play, box score, odds, win probability, teams, rosters, athletes, news, schedule / weeks, rankings. Not available or not verified: injuries (limited), ncaa tournament (not available).
Does the College Football API include betting odds?
Yes. Upcoming College Football games returned a spread, moneyline and total when we checked, from a single source book, with line history. It is not a multi-book comparison feed and not suited to sub-second in-play betting.
Does it include College Football injuries?
Partly. Only a handful of records are published for college football.
Can I get College Football score updates pushed instead of polling?
Yes. Webhooks are included on every paid plan (Starter, Growth, Pro, Business, Scale). WebSocket is included on paid plans, and the Free plan gets a 500-message monthly preview. Both can be filtered to college-football.