Get matchup history records between two teams.

Get matchup history records between two teams.

Usage

cfbd_team_matchup_records(team1, team2, min_year = NULL, max_year = NULL)

Arguments

team1

(String required): D-I Team 1

team2

(String required): D-I Team 2

min_year

(Integer optional): Minimum of year range, 4 digit format (YYYY)

max_year

(Integer optional): Maximum of year range, 4 digit format (YYYY)

Value

cfbd_team_matchup_records() - A data frame with 7 variables:

col_name	types	description
start_year	integer	Span starting year.
end_year	integer	Span ending year.
team1	character	First team selected in query.
team1_wins	integer	First team wins in series against team2.
team2	character	Second team selected in query.
team2_wins	integer	Second team wins in series against team1.
ties	integer	Number of ties in the series.

See also

Other CFBD Teams: cfbd_team_info(), cfbd_team_matchup(), cfbd_team_roster(), cfbd_team_talent()

Examples

# \donttest{
  try(cfbd_team_matchup_records("Texas", "Oklahoma"))
#> ── Team matchup record from CollegeFootballData.com ────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-24 02:05:25 UTC
#> # A tibble: 1 × 7
#>   start_year end_year team1 team1_wins team2    team2_wins  ties
#>        <int>    <int> <chr>      <int> <chr>         <int> <int>
#> 1       1902     2025 Texas         62 Oklahoma         51     5

  try(cfbd_team_matchup_records("Texas A&M", "TCU", min_year = 1975))
#> ── Team matchup record from CollegeFootballData.com ────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-24 02:05:25 UTC
#> # A tibble: 1 × 7
#>   start_year end_year team1     team1_wins team2 team2_wins  ties
#>        <int>    <int> <chr>          <int> <chr>      <int> <int>
#> 1       1975     2001 Texas A&M         22 TCU            0     0
# }