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

# GET /games/schedule

`GET /games/schedule`

Returns the active or next calendar slate, including completed games.
Explicit windows require year, seasonType, and week together.

## Query parameters

- `year` integer
- `seasonType` 'regular' | 'postseason'
- `week` integer
- `classification` 'fbs' | 'fcs'
- `conference` string

## Response `200`

Ok

- GameSchedule
  - `assembledAt` string, date-time, required
  - `selection` 'active' | 'next' | 'explicit' | 'none', required
  - `filters` object, required
    - `conference` string, nullable, required
    - `classification` 'fbs' | 'fcs', required
  - `window` ScheduleWindow, required
    - `year` integer, required
    - `seasonType` 'regular' | 'postseason', required
    - `week` integer, required
    - `startDate` string, date-time, required
    - `endDate` string, date-time, required — Exclusive UTC bound.
  - `followingWindow` ScheduleWindow, required
    - `year` integer, required
    - `seasonType` 'regular' | 'postseason', required
    - `week` integer, required
    - `startDate` string, date-time, required
    - `endDate` string, date-time, required — Exclusive UTC bound.
  - `games` ScheduleGame[], required
    - `id` integer, required
    - `season` integer, required
    - `week` integer, required
    - `seasonType` union, required
      - 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'
      - 'preseason'
    - `startDate` string, date-time, nullable, required
    - `startTimeTBD` boolean, nullable, required
    - `status` 'scheduled' | 'in_progress' | 'completed', required
    - `statusCheckedAt` string, date-time, required
    - `neutralSite` boolean, required
    - `conferenceGame` boolean, nullable, required
    - `venue` PreviewVenue, required
      - `id` integer, required
      - `name` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
    - `homeTeam` PreviewTeamIdentity, required
      - `id` integer, required
      - `name` string, required
      - `conference` string, nullable, required
      - `conferenceAbbreviation` string, nullable, required
      - `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii', required
      - `points` integer, nullable, required
    - `awayTeam` PreviewTeamIdentity, required
      - `id` integer, required
      - `name` string, required
      - `conference` string, nullable, required
      - `conferenceAbbreviation` string, nullable, required
      - `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii', required
      - `points` integer, nullable, required
    - `playoff` GamePlayoff, required
      - `competition` 'cfp', required
      - `format` string, required
      - `round` 'first_round' | 'quarterfinal' | 'semifinal' | 'championship', required
      - `roundName` string, required
      - `bracketSlot` string, required
      - `homeSeed` integer, nullable, required
      - `awaySeed` integer, nullable, required
      - `bowlName` string, nullable, required
    - `broadcasts` PreviewSectionPreviewBroadcastArray, required
      - `status` 'available' | 'no_data' | 'unavailable', required
      - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required
      - `assembledAt` string, date-time, required
      - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff.
      - `data` PreviewBroadcast[], nullable, required
        - `mediaType` 'tv' | 'radio' | 'web' | 'ppv' | 'mobile', required
        - `outlet` string, required
    - `odds` PreviewSectionSelectedOdds, required
      - `status` 'available' | 'no_data' | 'unavailable', required
      - `reason` 'no_data' | 'no_results_yet' | 'source_error' | 'invalid_data' | 'null', nullable, required
      - `assembledAt` string, date-time, required
      - `sourceUpdatedAt` string, date-time, nullable, required — Snapshot publication time, not a games-through cutoff.
      - `data` SelectedOdds, required
        - `providerId` integer, required
        - `provider` 'DraftKings' | 'Bovada', required
        - `spread` number, double, nullable, required — Home-relative spread; negative favors home.
        - `overUnder` number, double, nullable, required
        - `homeMoneyline` number, double, nullable, required
        - `awayMoneyline` number, double, nullable, required

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404`
- `503`

## Changes

- **2026-09-27** `a34b9a28cc81` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/changes/games/schedule/get.md)

---

[API](https://skmtc.dev/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/revisions/a34b9a28cc81?raw)