Get live game scoreboard information from games.
Arguments
- division
(String optional): Division abbreviation - Select a valid division: fbs/fcs/ii/iii
- conference
(String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC
Value
A data frame with one row per game on the current CFBD scoreboard. The
quarter columns depend on how far the games have gone: home_team_line_scores_Q1
and away_team_line_scores_Q1 are always present (all NA before any game starts),
_Q2 to _Q4 appear once any game in the result has reached that quarter, and
overtime adds _Q5 onward. So there are 37 variables before kickoff and 43 once a
game reaches the fourth quarter. An empty data frame is returned if the request fails.
| col_name | type | description |
| game_id | integer | CFBD-internal game id; join key to other CFBD endpoints. |
| start_date | character | Scheduled kickoff timestamp (ISO 8601, UTC). |
| start_time_tbd | logical | TRUE if the scheduled kickoff time is still to be determined. |
| tv | character | Television network broadcasting the game (e.g. ESPNU). |
| neutral_site | logical | TRUE if the game is being played at a neutral site. |
| conference_game | logical | TRUE if the game is a conference game. |
| status | character | Game status: scheduled, in_progress or completed. |
| period | integer | Current period/quarter number (1-4, 5+ for overtime); NA before kickoff. |
| clock | character | Game clock remaining in the current period, as sent by CFBD; NA before kickoff. |
| situation | character | Free-text down-and-distance / field-position summary for the current play; NA before kickoff. |
| possession | character | Team currently in possession, as sent by CFBD; NA before kickoff. |
| last_play | character | Free-text description of the most recent play; NA before kickoff. |
| venue_name | character | Stadium / venue name. |
| venue_city | character | City where the venue is located. |
| venue_state | character | State (or province/country) where the venue is located. |
| home_team_id | integer | CFBD-internal team id for the home team. |
| home_team_name | character | Home team display name including mascot (e.g. Kansas Jayhawks). |
| home_team_conference | character | Conference name of the home team. |
| home_team_classification | character | Division classification of the home team: fbs, fcs, ii, ii/iii or iii. |
| home_team_points | integer | Current total points scored by the home team; NA before kickoff. |
| home_team_line_scores_Q1 | integer | Home team points scored in the first quarter; NA before kickoff. |
| home_team_line_scores_Q2 | integer | Home team points scored in the second quarter; present once any game in the result has reached it. |
| home_team_line_scores_Q3 | integer | Home team points scored in the third quarter; present once any game in the result has reached it. |
| home_team_line_scores_Q4 | integer | Home team points scored in the fourth quarter; present once any game in the result has reached it. |
| home_team_win_probability | double | Home team win probability reported by CFBD; NA while the game is scheduled. |
| away_team_id | integer | CFBD-internal team id for the away team. |
| away_team_name | character | Away team display name including mascot (e.g. Middle Tennessee Blue Raiders). |
| away_team_conference | character | Conference name of the away team. |
| away_team_classification | character | Division classification of the away team: fbs, fcs, ii, ii/iii or iii. |
| away_team_points | integer | Current total points scored by the away team; NA before kickoff. |
| away_team_line_scores_Q1 | integer | Away team points scored in the first quarter; NA before kickoff. |
| away_team_line_scores_Q2 | integer | Away team points scored in the second quarter; present once any game in the result has reached it. |
| away_team_line_scores_Q3 | integer | Away team points scored in the third quarter; present once any game in the result has reached it. |
| away_team_line_scores_Q4 | integer | Away team points scored in the fourth quarter; present once any game in the result has reached it. |
| away_team_win_probability | double | Away team win probability reported by CFBD; NA while the game is scheduled. |
| weather_temperature | double | Temperature at kickoff, in degrees Fahrenheit. |
| weather_description | character | Free-text weather description (e.g. Clear, Light rain). |
| weather_wind_speed | double | Wind speed, in miles per hour. |
| weather_wind_direction | integer | Wind direction, in degrees (0-360, 0 = north). |
| betting_spread | double | Pre-game point spread relative to the home team (negative = home favored). |
| betting_over_under | double | Pre-game over/under (total) line in points. |
| betting_home_moneyline | integer | American-odds moneyline for the home team. |
| betting_away_moneyline | integer | American-odds moneyline for the away team. |
Examples
# \donttest{
try(cfbd_live_scoreboard(division='fbs', conference = "B12"))
#> ── Live Scoreboard information from CollegeFootballData.com ────────────────────
#> ℹ Data updated: 2026-10-11 01:03:42 UTC
#> # A tibble: 6 × 43
#> game_id start_date start_time_tbd tv neutral_site conference_game status
#> <int> <chr> <lgl> <chr> <lgl> <lgl> <chr>
#> 1 401856826 2026-10-10… FALSE ESPN FALSE TRUE compl…
#> 2 401856823 2026-10-10… FALSE TNT … FALSE TRUE compl…
#> 3 401856824 2026-10-10… FALSE ESPN2 FALSE TRUE compl…
#> 4 401856825 2026-10-10… FALSE Fox … FALSE TRUE compl…
#> 5 401856827 2026-10-11… FALSE ESPN FALSE TRUE in_pr…
#> 6 401856808 2026-10-11… FALSE FS1 FALSE FALSE sched…
#> # ℹ 36 more variables: period <int>, clock <chr>, situation <chr>,
#> # possession <chr>, last_play <chr>, venue_name <chr>, venue_city <chr>,
#> # venue_state <chr>, home_team_id <int>, home_team_name <chr>,
#> # home_team_conference <chr>, home_team_classification <chr>,
#> # home_team_points <int>, home_team_line_scores_Q1 <int>,
#> # home_team_line_scores_Q2 <int>, home_team_line_scores_Q3 <int>,
#> # home_team_line_scores_Q4 <int>, home_team_win_probability <dbl>, …
# }