cfbd 5.20.1 → 5.22.0

package/dist/types.gen.d.ts

@@ -302,6 +302,7 @@ export type CalendarWeek = {
      */
     lastGameStart: string;
 };
+export type CfpCoachSeasonOutcome = 'active' | 'eliminated' | 'champion';
 export type CfpPlayoff = {
     season: number;
     competition: PlayoffCompetition_Cfp;
@@ -317,18 +318,114 @@ export type CfpPlayoffNotFound = {
 };
 export type message = 'CFP playoff not found';
 export type Coach = {
+    id: number;
     firstName: string;
     lastName: string;
+    /**
+     * @deprecated
+     */
     hireDate: (string) | null;
     seasons: Array<CoachSeason>;
 };
+export type CoachAlmaMater = {
+    id: number;
+    school: string;
+};
+export type CoachCareer = {
+    games: number;
+    wins: number;
+    losses: number;
+    ties: number;
+    winPercentage: (number) | null;
+    seasons: number;
+    teams: number;
+    firstYear: number;
+    lastYear: number;
+};
+export type CoachCfpContext = {
+    appeared: boolean;
+    seed: (number) | null;
+    outcome: ((CfpCoachSeasonOutcome) | null);
+};
+export type CoachDraftContext = {
+    year: number;
+    totalPicks: number;
+    firstRoundPicks: number;
+};
+export type CoachNotFound = {
+    message: 'Coach not found';
+};
+export type message2 = 'Coach not found';
+export type CoachPollResume = {
+    preseasonRank: (number) | null;
+    postseasonRank: (number) | null;
+    bestRank: (number) | null;
+    weeksRanked: number;
+    weeksTopTen: number;
+};
+export type CoachProfile = {
+    id: number;
+    firstName: string;
+    lastName: string;
+    displayName: (string) | null;
+    currentTeam: ((CoachSeasonTeamReference) | null);
+    career: CoachCareer;
+    birthDate: (string) | null;
+    almaMater: ((CoachAlmaMater) | null);
+    graduationYear: (number) | null;
+    wikidataId: (string) | null;
+    hallOfFameYear: (number) | null;
+};
+export type CoachRatingContext = {
+    spSpecialTeams: (number) | null;
+    strengthOfSchedule: (number) | null;
+    secondOrderWins: (number) | null;
+    fpi: (number) | null;
+    yearOverYear: {
+        spOverall: (number) | null;
+        srs: (number) | null;
+        wins: (number) | null;
+    };
+};
+export type CoachRecord = {
+    games: number;
+    wins: number;
+    losses: number;
+    ties: number;
+    winPercentage: (number) | null;
+};
+export type CoachRecordSplits = {
+    conference: CoachRecord;
+    postseason: CoachRecord;
+    home: CoachRecord;
+    away: CoachRecord;
+    neutral: CoachRecord;
+};
+export type CoachRecruitingContext = {
+    rank: (number) | null;
+    points: (number) | null;
+    talent: (number) | null;
+};
+export type CoachReference = {
+    id: number;
+    firstName: string;
+    lastName: string;
+};
+export type CoachScoring = {
+    pointsFor: number;
+    pointsAgainst: number;
+    averagePointDifferential: (number) | null;
+};
 export type CoachSeason = {
+    teamId: number;
     school: string;
+    conference: (string) | null;
     year: number;
     games: number;
     wins: number;
     losses: number;
     ties: number;
+    winPercentage: (number) | null;
     preseasonRank: (number) | null;
     postseasonRank: (number) | null;
     srs: (number) | null;
@@ -336,6 +433,30 @@ export type CoachSeason = {
     spOffense: (number) | null;
     spDefense: (number) | null;
 };
+export type CoachSeasonTeamReference = {
+    id: number;
+    school: string;
+    conference: (string) | null;
+};
+export type CoachTeamReference = {
+    id: number;
+    school: string;
+};
+export type CoachTenure = {
+    id: number;
+    coach: CoachReference;
+    team: CoachTeamReference;
+    hireDate: (string) | null;
+    startYear: number;
+    endYear: (number) | null;
+    effectiveStart: (string) | null;
+    effectiveEnd: (string) | null;
+    isInterim: boolean;
+    active: boolean;
+    seasons: number;
+    record: CoachRecord;
+    attributionComplete: boolean;
+};
 export type Conference = {
     id: number;
     name: string;
@@ -378,6 +499,30 @@ export type ConferenceSP = {
         rating: (number) | null;
     };
 };
+export type DetailedCoachSeason = {
+    games: number;
+    wins: number;
+    losses: number;
+    ties: number;
+    winPercentage: (number) | null;
+    coach: CoachReference;
+    team: CoachSeasonTeamReference;
+    year: number;
+    preseasonRank: (number) | null;
+    postseasonRank: (number) | null;
+    srs: (number) | null;
+    spOverall: (number) | null;
+    spOffense: (number) | null;
+    spDefense: (number) | null;
+    teamMetrics: CoachRatingContext;
+    recruiting: CoachRecruitingContext;
+    pollResume: ((CoachPollResume) | null);
+    attributionComplete: boolean;
+    recordSplits: ((CoachRecordSplits) | null);
+    scoring: ((CoachScoring) | null);
+    cfp: CoachCfpContext;
+    draftFollowingSeason: ((CoachDraftContext) | null);
+};
 export type DivisionClassification = 'fbs' | 'fcs' | 'ii' | 'iii';
 export type DraftPick = {
     collegeAthleteId: (number) | null;
@@ -1596,15 +1741,15 @@ export type Venue = {
 export type GetAdjustedTeamSeasonStatsData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -1614,19 +1759,19 @@ export type GetAdjustedTeamSeasonStatsError = unknown;
 export type GetAdjustedPlayerPassingStatsData = {
     query?: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional position abbreviation filter
+         * Player position abbreviation.
          */
         position?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -1636,19 +1781,19 @@ export type GetAdjustedPlayerPassingStatsError = unknown;
 export type GetAdjustedPlayerRushingStatsData = {
     query?: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional position abbreviation filter
+         * Player position abbreviation.
          */
         position?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -1658,15 +1803,15 @@ export type GetAdjustedPlayerRushingStatsError = unknown;
 export type GetKickerPaarData = {
     query?: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -1676,11 +1821,11 @@ export type GetKickerPaarError = unknown;
 export type GetTeamsData = {
     query?: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional year filter to get historical conference affiliations
+         * Season year for historical conference affiliations.
          */
         year?: number;
     };
@@ -1690,7 +1835,7 @@ export type GetTeamsError = unknown;
 export type GetFbsTeamsData = {
     query?: {
         /**
-         * Year or season
+         * Season year.
          */
         year?: number;
     };
@@ -1700,19 +1845,19 @@ export type GetFbsTeamsError = unknown;
 export type GetMatchupData = {
     query: {
         /**
-         * Optional ending year
+         * Latest season year to include.
          */
         maxYear?: number;
         /**
-         * Optional starting year
+         * Earliest season year to include.
          */
         minYear?: number;
         /**
-         * First team to compare
+         * First team name.
          */
         team1: string;
         /**
-         * Second team to compare
+         * Second team name.
          */
         team2: string;
     };
@@ -1722,15 +1867,15 @@ export type GetMatchupError = unknown;
 export type GetTeamsAtsData = {
     query: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -1740,15 +1885,15 @@ export type GetTeamsAtsError = unknown;
 export type GetRosterData = {
     query?: {
         /**
-         * Optional filter to only include players from FBS or FCS teams
+         * Division classification: `fbs` or `fcs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter, defaults to 2025
+         * Season year. Defaults to 2025.
          */
         year?: number;
     };
@@ -1760,7 +1905,7 @@ export type GetConferencesError = unknown;
 export type GetTalentData = {
     query: {
         /**
-         * Year filter
+         * Season year.
          */
         year: number;
     };
@@ -1772,31 +1917,31 @@ export type GetVenuesError = unknown;
 export type GetPlayerSeasonStatsData = {
     query: {
         /**
-         * Optional category filter
+         * Statistical category.
          */
         category?: string;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional ending week range
+         * Latest week to include.
          */
         endWeek?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional starting week range
+         * Earliest week to include.
          */
         startWeek?: number;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -1806,39 +1951,39 @@ export type GetPlayerSeasonStatsError = unknown;
 export type GetPlayerSeasonSuccessRatesData = {
     query?: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional ending week range
+         * Latest week to include.
          */
         endWeek?: number;
         /**
-         * Optional flag to exclude garbage time plays
+         * Excludes garbage-time plays when `true`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Player ID filter, required if year not specified
+         * Player ID. Required unless `year` is specified.
          */
         playerId?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional starting week range
+         * Earliest week to include.
          */
         startWeek?: number;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional minimum credited passing plus rushing plays
+         * Minimum credited passing and rushing plays.
          */
         threshold?: number;
         /**
-         * Year filter, required if playerId not specified
+         * Season year. Required unless `playerId` is specified.
          */
         year?: number;
     };
@@ -1848,35 +1993,35 @@ export type GetPlayerSeasonSuccessRatesError = unknown;
 export type GetPlayerGameSuccessRatesData = {
     query: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional flag to exclude garbage time plays
+         * Excludes garbage-time plays when `true`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Optional player ID filter
+         * Player ID.
          */
         playerId?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional minimum credited passing plus rushing plays
+         * Minimum credited passing and rushing plays.
          */
         threshold?: number;
         /**
-         * Week filter, required if team and playerId not specified
+         * Week number. Required unless `team` or `playerId` is specified.
          */
         week?: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -1886,27 +2031,27 @@ export type GetPlayerGameSuccessRatesError = unknown;
 export type GetTeamStatsData = {
     query?: {
         /**
-         * Optional division classification filter, defaults to fbs
+         * Division classification. Defaults to `fbs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional week end range filter
+         * Latest week to include.
          */
         endWeek?: number;
         /**
-         * Optional week start range filter
+         * Earliest week to include.
          */
         startWeek?: number;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -1918,27 +2063,28 @@ export type GetCategoriesError = unknown;
 export type GetAdvancedSeasonStatsData = {
     query?: {
         /**
-         * Optional division classification filter, defaults to fbs
+         * Division classification. Defaults to `fbs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional end week range filter
+         * Latest week to include.
          */
         endWeek?: number;
         /**
-         * Garbage time exclusion filter, defaults to false
+         * Excludes garbage-time plays when `true`. Defaults
+         * to `false`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Optional start week range filter
+         * Earliest week to include.
          */
         startWeek?: number;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -1948,27 +2094,28 @@ export type GetAdvancedSeasonStatsError = unknown;
 export type GetAdvancedGameStatsData = {
     query?: {
         /**
-         * Garbage time exclusion filter, defaults to false
+         * Excludes garbage-time plays when `true`. Defaults
+         * to `false`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Optional opponent filter
+         * Opponent team name.
          */
         opponent?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -1978,23 +2125,23 @@ export type GetAdvancedGameStatsError = unknown;
 export type GetGameHavocStatsData = {
     query?: {
         /**
-         * Optional opponent filter
+         * Opponent team name.
          */
         opponent?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2004,23 +2151,23 @@ export type GetGameHavocStatsError = unknown;
 export type GetRecruitsData = {
     query?: {
         /**
-         * Optional recruit type classification filter, defaults to HighSchool
+         * Recruit classification. Defaults to `HighSchool`.
          */
         classification?: RecruitClassification;
         /**
-         * Optional position categorization filter
+         * Position category.
          */
         position?: string;
         /**
-         * Optional state/province filter
+         * State or province abbreviation.
          */
         state?: string;
         /**
-         * Team filter, required when no team specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required when no team specified
+         * Recruiting class year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2030,11 +2177,11 @@ export type GetRecruitsError = unknown;
 export type GetTeamRecruitingRankingsData = {
     query?: {
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Recruiting class year.
          */
         year?: number;
     };
@@ -2044,23 +2191,23 @@ export type GetTeamRecruitingRankingsError = unknown;
 export type GetAggregatedTeamRecruitingRatingsData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional end year range, defaults to current year
+         * Latest recruiting class year. Defaults to the current year.
          */
         endYear?: number;
         /**
-         * Optional recruit type filter, defaults to HighSchool
+         * Recruit classification. Defaults to `HighSchool`.
          */
         recruitType?: RecruitClassification;
         /**
-         * Optional start year range, defaults to 2000
+         * Earliest recruiting class year. Defaults to 2000.
          */
         startYear?: number;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
     };
@@ -2070,11 +2217,11 @@ export type GetAggregatedTeamRecruitingRatingsError = unknown;
 export type GetSpData = {
     query?: {
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2084,15 +2231,15 @@ export type GetSpError = unknown;
 export type GetConferenceSpData = {
     query?: {
         /**
-         * Optional division classification filter, defaults to fbs
+         * Division classification. Defaults to `fbs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -2102,15 +2249,15 @@ export type GetConferenceSpError = unknown;
 export type GetSrsData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2120,19 +2267,19 @@ export type GetSrsError = unknown;
 export type GetExpandedSrsData = {
     query?: {
         /**
-         * Optional division classification filter (fbs or fcs)
+         * Division classification: `fbs` or `fcs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2142,23 +2289,24 @@ export type GetExpandedSrsError = unknown;
 export type GetEloData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional week filter, defaults to last available week in the season
+         * Week number. Defaults to the latest available week in the
+         * season.
          */
         week?: number;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -2168,15 +2316,15 @@ export type GetEloError = unknown;
 export type GetFpiData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2186,27 +2334,30 @@ export type GetFpiError = unknown;
 export type GetRankingsData = {
     query: {
         /**
-         * Return the marked final CFP snapshot
+         * Returns the CFP snapshot marked as final when `true`. Requires
+         * `poll=cfp` and cannot be combined with `latest`.
          */
         final?: boolean;
         /**
-         * Return the latest CFP snapshot, preferring the marked final
+         * Returns the latest CFP snapshot when `true`, preferring the
+         * snapshot marked as final. Requires `poll=cfp` and cannot be combined with
+         * `final`.
          */
         latest?: boolean;
         /**
-         * Optional poll filter
+         * Poll name.
          */
         poll?: RankingPoll;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional week filter
+         * Poll week.
          */
         week?: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2218,47 +2369,47 @@ export type GetRankingsError = ({
 export type GetPlaysData = {
     query: {
         /**
-         * Optional division classification filter
+         * Division classification of either team.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference of either team.
          */
         conference?: string;
         /**
-         * Optional defensive team filter
+         * Defensive team name.
          */
         defense?: string;
         /**
-         * Optional defensive conference filter
+         * Defensive team conference.
          */
         defenseConference?: string;
         /**
-         * Optional offensive team filter
+         * Offensive team name.
          */
         offense?: string;
         /**
-         * Optional offensive conference filter
+         * Offensive team conference.
          */
         offenseConference?: string;
         /**
-         * Optoinal play type abbreviation filter
+         * Play type abbreviation.
          */
         playType?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name on either side of the play.
          */
         team?: string;
         /**
-         * Required week filter
+         * Week number.
          */
         week: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2270,35 +2421,35 @@ export type GetPlayTypesError = unknown;
 export type GetPlayStatsData = {
     query?: {
         /**
-         * Optional athleteId filter
+         * Athlete ID.
          */
         athleteId?: number;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional gameId filter
+         * Game ID.
          */
         gameId?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional statTypeId filter
+         * Play stat type ID.
          */
         statTypeId?: number;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -2310,7 +2461,7 @@ export type GetPlayStatTypesError = unknown;
 export type GetCfpPlayoffData = {
     query: {
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2322,7 +2473,7 @@ export type GetCfpPlayoffError = ({
 export type GetCfpParticipantsData = {
     query: {
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2334,11 +2485,11 @@ export type GetCfpParticipantsError = ({
 export type GetCfpGamesData = {
     query: {
         /**
-         * Optional playoff round filter
+         * Playoff round.
          */
         round?: PlayoffRound;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2350,19 +2501,19 @@ export type GetCfpGamesError = ({
 export type SearchPlayersData = {
     query: {
         /**
-         * Optional position abbreviation filter
+         * Player position abbreviation.
          */
         position?: string;
         /**
-         * Search term for matching player name
+         * Full or partial player name.
          */
         searchTerm: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -2372,27 +2523,28 @@ export type SearchPlayersError = unknown;
 export type GetPlayerUsageData = {
     query: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional exclude garbage time flag, defaults to false
+         * Excludes garbage-time plays when `true`. Defaults
+         * to `false`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Optional player id filter
+         * Player ID.
          */
         playerId?: number;
         /**
-         * Optional position abbreivation filter
+         * Player position abbreviation.
          */
         position?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2402,11 +2554,11 @@ export type GetPlayerUsageError = unknown;
 export type GetPlayerSeasonOverviewData = {
     query: {
         /**
-         * Required player id filter
+         * Player ID.
          */
         playerId: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2416,15 +2568,15 @@ export type GetPlayerSeasonOverviewError = unknown;
 export type GetReturningProductionData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2434,7 +2586,7 @@ export type GetReturningProductionError = unknown;
 export type GetTransferPortalData = {
     query: {
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2444,11 +2596,11 @@ export type GetTransferPortalError = unknown;
 export type GetPredictedPointsData = {
     query: {
         /**
-         * Distance value
+         * Distance to gain, in yards.
          */
         distance: number;
         /**
-         * Down value
+         * Down number.
          */
         down: number;
     };
@@ -2458,23 +2610,23 @@ export type GetPredictedPointsError = unknown;
 export type GetPredictedPointsAddedByTeamData = {
     query?: {
         /**
-         * Optional division classification filter, defaults to fbs
+         * Division classification. Defaults to `fbs`.
          */
         classification?: DivisionClassification;
         /**
-         * Conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Exclude garbage time plays
+         * Excludes garbage-time plays when `true`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2484,31 +2636,31 @@ export type GetPredictedPointsAddedByTeamError = unknown;
 export type GetPredictedPointsAddedByGameData = {
     query: {
         /**
-         * Optional division classification filter, defaults to fbs
+         * Division classification. Defaults to `fbs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional flag to exclude garbage time plays
+         * Excludes garbage-time plays when `true`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2518,35 +2670,35 @@ export type GetPredictedPointsAddedByGameError = unknown;
 export type GetPredictedPointsAddedByPlayerGameData = {
     query: {
         /**
-         * Optional flag to exclude garbage time plays
+         * Excludes garbage-time plays when `true`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Optional player ID filter
+         * Player ID.
          */
         playerId?: string;
         /**
-         * Optional player position abbreviation filter
+         * Player position abbreviation.
          */
         position?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Team filter, required if week not specified
+         * Team name. Required unless `week` is specified.
          */
         team?: string;
         /**
-         * Threshold value for minimum number of plays
+         * Minimum number of plays.
          */
         threshold?: number;
         /**
-         * Week filter, required if team not specified
+         * Week number. Required unless `team` is specified.
          */
         week?: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2556,31 +2708,31 @@ export type GetPredictedPointsAddedByPlayerGameError = unknown;
 export type GetPredictedPointsAddedByPlayerSeasonData = {
     query?: {
         /**
-         * Optional conference abbreviation filter
+         * Conference abbreviation.
          */
         conference?: string;
         /**
-         * Optional flag to exclude garbage time plays
+         * Excludes garbage-time plays when `true`.
          */
         excludeGarbageTime?: boolean;
         /**
-         * Player ID filter, required if year not specified
+         * Player ID. Required unless `year` is specified.
          */
         playerId?: string;
         /**
-         * Optional position abbreviation filter
+         * Player position abbreviation.
          */
         position?: string;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Threshold value for minimum number of plays
+         * Minimum number of plays.
          */
         threshold?: number;
         /**
-         * Year filter, required if playerId not specified
+         * Season year. Required unless `playerId` is specified.
          */
         year?: number;
     };
@@ -2590,7 +2742,7 @@ export type GetPredictedPointsAddedByPlayerSeasonError = unknown;
 export type GetWinProbabilityData = {
     query: {
         /**
-         * Required game ID filter
+         * Game ID.
          */
         gameId: number;
     };
@@ -2600,19 +2752,19 @@ export type GetWinProbabilityError = unknown;
 export type GetPregameWinProbabilitiesData = {
     query?: {
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
@@ -2624,7 +2776,7 @@ export type GetFieldGoalExpectedPointsError = unknown;
 export type GetLivePlaysData = {
     query: {
         /**
-         * Game Id filter
+         * Game ID.
          */
         gameId: number;
     };
@@ -2634,39 +2786,39 @@ export type GetLivePlaysError = unknown;
 export type GetLinesData = {
     query?: {
         /**
-         * Optional away team filter
+         * Away team name.
          */
         away?: string;
         /**
-         * Optional conference filter
+         * Conference of either team.
          */
         conference?: string;
         /**
-         * Optional gameId filter
+         * Game ID.
          */
         gameId?: number;
         /**
-         * Optional home team filter
+         * Home team name.
          */
         home?: string;
         /**
-         * Optional provider name filter
+         * Betting line provider.
          */
         provider?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name on either side of the game.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Year filter, required if game id not specified
+         * Season year. Required unless `gameId` is specified.
          */
         year?: number;
     };
@@ -2678,15 +2830,16 @@ export type GetUserInfoError = unknown;
 export type GetUsageData = {
     query?: {
         /**
-         * Optional API filter: all, cfb, or cbb
+         * API to include: `all`, `cfb`, or `cbb`.
          */
         api?: UserUsageApi;
         /**
-         * Number of trailing days to include, defaults to 7 and is capped at 31
+         * Trailing days to include. Defaults to 7; maximum 31.
          */
         days?: number;
         /**
-         * Number of endpoint and recent request rows to return, defaults to 10 and is capped at 50
+         * Maximum endpoint and request rows to return. Defaults to 10;
+         * maximum 50.
          */
         limit?: number;
     };
@@ -2696,47 +2849,47 @@ export type GetUsageError = unknown;
 export type GetGamesData = {
     query?: {
         /**
-         * Optional away team filter
+         * Away team name.
          */
         away?: string;
         /**
-         * Optional division classification filter
+         * Division classification.
          */
         classification?: DivisionClassification;
         /**
-         * Optional playoff competition filter
+         * Playoff competition.
          */
         competition?: PlayoffCompetition;
         /**
-         * Optional conference filter
+         * Conference of either team.
          */
         conference?: string;
         /**
-         * Optional home team filter
+         * Home team name.
          */
         home?: string;
         /**
-         * Game id filter to retrieve a single game
+         * Game ID. When specified, returns data for that game.
          */
         id?: number;
         /**
-         * Optional playoff round filter; requires competition
+         * Playoff round. Requires `competition`.
          */
         round?: PlayoffRound;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name on either side of the game.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Required year filter (except when id is specified)
+         * Season year. Required unless `id` is specified.
          */
         year?: number;
     };
@@ -2748,31 +2901,34 @@ export type GetGamesError = ({
 export type GetGameTeamStatsData = {
     query?: {
         /**
-         * Optional division classification filter
+         * Division classification.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter, required if week and team not specified
+         * Conference name or abbreviation. One of `week`, `team`,
+         * or `conference` is required when filtering by year.
          */
         conference?: string;
         /**
-         * Optional id filter to retrieve a single game
+         * Game ID. When specified, returns statistics for that game.
          */
         id?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter, required if week and conference not specified
+         * Team name. One of `week`, `team`, or `conference` is required
+         * when filtering by year.
          */
         team?: string;
         /**
-         * Optional week filter, required if team and conference not specified
+         * Week number. One of `week`, `team`, or `conference` is required
+         * when filtering by year.
          */
         week?: number;
         /**
-         * Required year filter (along with one of week, team, or conference), unless id is specified
+         * Season year. Required unless `id` is specified.
          */
         year?: number;
     };
@@ -2782,35 +2938,38 @@ export type GetGameTeamStatsError = unknown;
 export type GetGamePlayerStatsData = {
     query?: {
         /**
-         * Optional player statistical category filter
+         * Player statistical category.
          */
         category?: string;
         /**
-         * Optional division classification filter
+         * Division classification.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter, required if week and team not specified
+         * Conference name or abbreviation. One of `week`, `team`,
+         * or `conference` is required when filtering by year.
          */
         conference?: string;
         /**
-         * Optional id filter to retrieve a single game
+         * Game ID. When specified, returns statistics for that game.
          */
         id?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter, required if week and conference not specified
+         * Team name. One of `week`, `team`, or `conference` is required
+         * when filtering by year.
          */
         team?: string;
         /**
-         * Optional week filter, required if team and conference not specified
+         * Week number. One of `week`, `team`, or `conference` is required
+         * when filtering by year.
          */
         week?: number;
         /**
-         * Required year filter (along with one of week, team, or conference), unless id is specified
+         * Season year. Required unless `id` is specified.
          */
         year?: number;
     };
@@ -2820,31 +2979,31 @@ export type GetGamePlayerStatsError = unknown;
 export type GetMediaData = {
     query: {
         /**
-         * Optional division classification filter
+         * Division classification.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional media type filter
+         * Media type.
          */
         mediaType?: MediaType;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2854,31 +3013,31 @@ export type GetMediaError = unknown;
 export type GetWeatherData = {
     query?: {
         /**
-         * Optional division classification filter
+         * Division classification.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Filter for retrieving a single game
+         * Game ID. When specified, returns weather for that game.
          */
         gameId?: number;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Year filter, required if game id not specified
+         * Season year. Required unless `gameId` is specified.
          */
         year?: number;
     };
@@ -2888,15 +3047,15 @@ export type GetWeatherError = unknown;
 export type GetRecordsData = {
     query?: {
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Team filter, required if year not specified
+         * Team name. Required unless `year` is specified.
          */
         team?: string;
         /**
-         * Year filter, required if team not specified
+         * Season year. Required unless `team` is specified.
          */
         year?: number;
     };
@@ -2906,7 +3065,7 @@ export type GetRecordsError = unknown;
 export type GetCalendarData = {
     query: {
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2916,11 +3075,11 @@ export type GetCalendarError = unknown;
 export type GetScoreboardData = {
     query?: {
         /**
-         * Optional division classification filter, defaults to fbs
+         * Division classification. Defaults to `fbs`.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference name or abbreviation.
          */
         conference?: string;
     };
@@ -2930,43 +3089,43 @@ export type GetScoreboardError = unknown;
 export type GetDrivesData = {
     query: {
         /**
-         * Optional division classification filter
+         * Division classification of either team.
          */
         classification?: DivisionClassification;
         /**
-         * Optional conference filter
+         * Conference of either team.
          */
         conference?: string;
         /**
-         * Optional defensive team filter
+         * Defensive team name.
          */
         defense?: string;
         /**
-         * Optional defensive team conference filter
+         * Defensive team conference.
          */
         defenseConference?: string;
         /**
-         * Optional offensive team filter
+         * Offensive team name.
          */
         offense?: string;
         /**
-         * Optional offensive team conference filter
+         * Offensive team conference.
          */
         offenseConference?: string;
         /**
-         * Optional season type filter
+         * Season type.
          */
         seasonType?: SeasonType;
         /**
-         * Optional team filter
+         * Team name on either side of the drive.
          */
         team?: string;
         /**
-         * Optional week filter
+         * Week number.
          */
         week?: number;
         /**
-         * Required year filter
+         * Season year.
          */
         year: number;
     };
@@ -2980,23 +3139,23 @@ export type GetDraftPositionsError = unknown;
 export type GetDraftPicksData = {
     query?: {
         /**
-         * Optional college conference filter
+         * College conference name or abbreviation.
          */
         conference?: string;
         /**
-         * Optional position classification filter
+         * Position category.
          */
         position?: string;
         /**
-         * Optional college team filter
+         * College team name.
          */
         school?: string;
         /**
-         * Optional NFL team filter
+         * NFL team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Draft year.
          */
         year?: number;
     };
@@ -3006,37 +3165,101 @@ export type GetDraftPicksError = unknown;
 export type GetCoachesData = {
     query?: {
         /**
-         * Optional first name filter
+         * Coach first name.
          */
         firstName?: string;
         /**
-         * Optional last name filter
+         * Coach last name.
          */
         lastName?: string;
         /**
-         * Optional end year range filter
+         * Latest season year to include.
          */
         maxYear?: number;
         /**
-         * Optional start year range filter
+         * Earliest season year to include.
          */
         minYear?: number;
         /**
-         * Optional team filter
+         * Team name.
          */
         team?: string;
         /**
-         * Optional year filter
+         * Season year.
          */
         year?: number;
     };
 };
 export type GetCoachesResponse = (Array<Coach>);
 export type GetCoachesError = unknown;
+export type GetCoachProfileData = {
+    query: {
+        /**
+         * Coach ID.
+         */
+        coachId: number;
+    };
+};
+export type GetCoachProfileResponse = (CoachProfile);
+export type GetCoachProfileError = ({
+    message: string;
+} | CoachNotFound);
+export type GetCoachSeasonsData = {
+    query?: {
+        /**
+         * Coach ID.
+         */
+        coachId?: number;
+        /**
+         * Latest season year to include.
+         */
+        maxYear?: number;
+        /**
+         * Earliest season year to include.
+         */
+        minYear?: number;
+        /**
+         * Team name.
+         */
+        team?: string;
+        /**
+         * Exact season year.
+         */
+        year?: number;
+    };
+};
+export type GetCoachSeasonsResponse = (Array<DetailedCoachSeason>);
+export type GetCoachSeasonsError = ({
+    message: string;
+});
+export type GetCoachTenuresData = {
+    query?: {
+        /**
+         * Filters by active status when specified.
+         */
+        active?: boolean;
+        /**
+         * Coach ID.
+         */
+        coachId?: number;
+        /**
+         * Team name.
+         */
+        team?: string;
+        /**
+         * Season year contained within the tenure.
+         */
+        year?: number;
+    };
+};
+export type GetCoachTenuresResponse = (Array<CoachTenure>);
+export type GetCoachTenuresError = ({
+    message: string;
+});
 export type GetAdvancedBoxScoreData = {
     query: {
         /**
-         * Required game id filter
+         * Game ID.
          */
         id: number;
     };