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

# GET /playoffs/cfp

`GET /playoffs/cfp`

Returns the complete College Football Playoff bracket for a season.

## Query parameters

- `year` integer, required

## Response `200`

Ok

- CfpPlayoff
  - `season` integer, required
  - `competition` 'cfp', required
  - `format` string, required
  - `teamCount` integer, required
  - `status` 'scheduled' | 'selected' | 'in_progress' | 'completed', required
  - `participants` PlayoffParticipant[], required
    - `team` PlayoffTeam, required
      - `id` integer, required
      - `school` string, required
      - `conference` string, nullable, required
    - `committeeRank` integer, nullable, required
    - `seed` integer, required
    - `bidType` 'automatic' | 'at_large', required
    - `qualificationReason` string, nullable, required
    - `conferenceChampion` boolean, required
    - `qualifyingConference` string, nullable, required
    - `firstRoundBye` boolean, required
    - `outcome` 'active' | 'eliminated' | 'champion', required
    - `eliminatedRound` 'first_round' | 'quarterfinal' | 'semifinal' | 'championship', required
  - `rounds` PlayoffRoundRecord[], required
    - `code` 'first_round' | 'quarterfinal' | 'semifinal' | 'championship', required
    - `name` string, required
    - `order` integer, required
    - `matchups` PlayoffMatchup[], required
      - `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
  - `champion` PlayoffTeam, required
    - `id` integer, required
    - `school` string, required
    - `conference` string, nullable, 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)