---
title: "GET /playoffs/cfp/games"
method: GET
path: "/playoffs/cfp/games"
tags: ["playoffs"]
---

# GET /playoffs/cfp/games

`GET /playoffs/cfp/games`

Returns College Football Playoff matchups for a season.

## Query parameters

- `year` integer, required
- `round` 'first_round' | 'quarterfinal' | 'semifinal' | 'championship'

## Response `200`

Ok

- PlayoffMatchup[]
  - `id` integer, required
  - `bracketSlot` string, required
  - `round` 'first_round' | 'quarterfinal' | 'semifinal' | 'championship', required
  - `roundName` string, required
  - `roundOrder` integer, required
  - `matchupOrder` integer, required
  - `startDate` string, date-time, nullable, required
  - `bowlName` string, nullable, required
  - `slots` PlayoffMatchupSlot[], required
    - `position` integer, required
    - `seed` integer, nullable, required
    - `participant` PlayoffTeam, required
      - `id` integer, required
      - `school` string, required
      - `conference` string, nullable, required
    - `source` PlayoffMatchupSlotSource, required
      - `matchupId` integer, required
      - `bracketSlot` string, required
      - `outcome` 'winner', required
  - `game` PlayoffLinkedGame, required
    - `id` integer, required
    - `startDate` string, date-time, required
    - `completed` boolean, required
    - `homeTeam` PlayoffTeam, required
      - `id` integer, required
      - `school` string, required
      - `conference` string, nullable, required
    - `homePoints` integer, nullable, required
    - `awayTeam` PlayoffTeam, required
      - `id` integer, required
      - `school` string, required
      - `conference` string, nullable, required
    - `awayPoints` integer, nullable, required
    - `venueId` integer, nullable, required
    - `venue` string, nullable, required
  - `advancesTo` PlayoffAdvancement, required
    - `matchupId` integer, required
    - `bracketSlot` string, required
    - `position` integer, required

## Other responses

- `400` — Validation error
- `404`

---

[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/cd2844c1ac5c/schema)