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

# GET /records

`GET /records`

Returns historical team records by season.

## Query parameters

- `year` integer
- `team` string
- `conference` string

## Response `200`

Ok

- TeamRecords[]
  - `year` integer, required
  - `teamId` integer, required
  - `team` string, required
  - `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii', required
  - `conference` string, required
  - `division` string, required
  - `expectedWins` number, double, nullable, required
  - `total` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required
  - `conferenceGames` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required
  - `homeGames` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required
  - `awayGames` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required
  - `neutralSiteGames` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required
  - `regularSeason` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required
  - `postseason` TeamRecord, required
    - `games` integer, required
    - `wins` integer, required
    - `losses` integer, required
    - `ties` integer, required

## Changes

- **2026-08-19** `2753e757620d` — 1 warning
  - added the new `ii/iii` enum value to the `items/classification/allOf[#/components/schemas/DivisionClassification]/` response property for the response status `200`

[Change history](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/changes/records/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/c44a00d614f0?raw)