---
title: "GET /teams/matchup"
method: GET
path: "/teams/matchup"
tags: ["teams"]
---

# GET /teams/matchup

`GET /teams/matchup`

Returns historical matchup results between two teams.

## Query parameters

- `team1` string, required
- `team2` string, required
- `minYear` integer
- `maxYear` integer

## Response `200`

Ok

- Matchup
  - `team1` string, required
  - `team2` string, required
  - `startYear` integer
  - `endYear` integer
  - `team1Wins` integer, required
  - `team2Wins` integer, required
  - `ties` integer, required
  - `games` MatchupGame[], required
    - `season` integer, required
    - `week` integer, required
    - `seasonType` string, required
    - `date` string, required
    - `neutralSite` boolean, required
    - `venue` string, nullable, required
    - `homeTeam` string, required
    - `homeScore` integer, nullable, required
    - `awayTeam` string, required
    - `awayScore` integer, nullable, required
    - `winner` string, nullable, required

---

[API](https://skmtc.net/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.net/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collegefootballdata/college-football-data-api/revisions/2753e757620d/schema)