---
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' | '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

---

[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)