cfbd 5.20.0 → 5.21.0

package/dist/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type OptionsLegacyParser } from '@hey-api/client-fetch';
-import type { GetAdjustedTeamSeasonStatsData, GetAdjustedTeamSeasonStatsResponse, GetAdjustedPlayerPassingStatsData, GetAdjustedPlayerPassingStatsResponse, GetAdjustedPlayerRushingStatsData, GetAdjustedPlayerRushingStatsResponse, GetKickerPaarData, GetKickerPaarResponse, GetTeamsData, GetTeamsResponse, GetFbsTeamsData, GetFbsTeamsResponse, GetMatchupData, GetTeamsAtsData, GetTeamsAtsResponse, GetRosterData, GetRosterResponse, GetConferencesResponse, GetTalentData, GetTalentResponse, GetVenuesResponse, GetPlayerSeasonStatsData, GetPlayerSeasonStatsResponse, GetPlayerSeasonSuccessRatesData, GetPlayerSeasonSuccessRatesResponse, GetPlayerGameSuccessRatesData, GetPlayerGameSuccessRatesResponse, GetTeamStatsData, GetTeamStatsResponse, GetCategoriesResponse, GetAdvancedSeasonStatsData, GetAdvancedSeasonStatsResponse, GetAdvancedGameStatsData, GetAdvancedGameStatsResponse, GetGameHavocStatsData, GetGameHavocStatsResponse, GetRecruitsData, GetRecruitsResponse, GetTeamRecruitingRankingsData, GetTeamRecruitingRankingsResponse, GetAggregatedTeamRecruitingRatingsData, GetAggregatedTeamRecruitingRatingsResponse, GetSpData, GetSpResponse, GetConferenceSpData, GetConferenceSpResponse, GetSrsData, GetSrsResponse, GetExpandedSrsData, GetExpandedSrsResponse, GetEloData, GetEloResponse, GetFpiData, GetFpiResponse, GetRankingsData, GetRankingsError, GetRankingsResponse, GetPlaysData, GetPlaysResponse, GetPlayTypesResponse, GetPlayStatsData, GetPlayStatsResponse, GetPlayStatTypesResponse, GetCfpPlayoffData, GetCfpPlayoffError, GetCfpParticipantsData, GetCfpParticipantsError, GetCfpParticipantsResponse, GetCfpGamesData, GetCfpGamesError, GetCfpGamesResponse, SearchPlayersData, SearchPlayersResponse, GetPlayerUsageData, GetPlayerUsageResponse, GetPlayerSeasonOverviewData, GetReturningProductionData, GetReturningProductionResponse, GetTransferPortalData, GetTransferPortalResponse, GetPredictedPointsData, GetPredictedPointsResponse, GetPredictedPointsAddedByTeamData, GetPredictedPointsAddedByTeamResponse, GetPredictedPointsAddedByGameData, GetPredictedPointsAddedByGameResponse, GetPredictedPointsAddedByPlayerGameData, GetPredictedPointsAddedByPlayerGameResponse, GetPredictedPointsAddedByPlayerSeasonData, GetPredictedPointsAddedByPlayerSeasonResponse, GetWinProbabilityData, GetWinProbabilityResponse, GetPregameWinProbabilitiesData, GetPregameWinProbabilitiesResponse, GetFieldGoalExpectedPointsResponse, GetLivePlaysData, GetLinesData, GetLinesResponse, GetUserInfoResponse, GetUsageData, GetUsageResponse, GetGamesData, GetGamesError, GetGamesResponse, GetGameTeamStatsData, GetGameTeamStatsResponse, GetGamePlayerStatsData, GetGamePlayerStatsResponse, GetMediaData, GetMediaResponse, GetWeatherData, GetWeatherResponse, GetRecordsData, GetRecordsResponse, GetCalendarData, GetCalendarResponse, GetScoreboardData, GetScoreboardResponse, GetDrivesData, GetDrivesResponse, GetDraftTeamsResponse, GetDraftPositionsResponse, GetDraftPicksData, GetDraftPicksResponse, GetCoachesData, GetCoachesResponse, GetAdvancedBoxScoreData } from './types.gen';
+import type { GetAdjustedTeamSeasonStatsData, GetAdjustedTeamSeasonStatsResponse, GetAdjustedPlayerPassingStatsData, GetAdjustedPlayerPassingStatsResponse, GetAdjustedPlayerRushingStatsData, GetAdjustedPlayerRushingStatsResponse, GetKickerPaarData, GetKickerPaarResponse, GetTeamsData, GetTeamsResponse, GetFbsTeamsData, GetFbsTeamsResponse, GetMatchupData, GetTeamsAtsData, GetTeamsAtsResponse, GetRosterData, GetRosterResponse, GetConferencesResponse, GetTalentData, GetTalentResponse, GetVenuesResponse, GetPlayerSeasonStatsData, GetPlayerSeasonStatsResponse, GetPlayerSeasonSuccessRatesData, GetPlayerSeasonSuccessRatesResponse, GetPlayerGameSuccessRatesData, GetPlayerGameSuccessRatesResponse, GetTeamStatsData, GetTeamStatsResponse, GetCategoriesResponse, GetAdvancedSeasonStatsData, GetAdvancedSeasonStatsResponse, GetAdvancedGameStatsData, GetAdvancedGameStatsResponse, GetGameHavocStatsData, GetGameHavocStatsResponse, GetRecruitsData, GetRecruitsResponse, GetTeamRecruitingRankingsData, GetTeamRecruitingRankingsResponse, GetAggregatedTeamRecruitingRatingsData, GetAggregatedTeamRecruitingRatingsResponse, GetSpData, GetSpResponse, GetConferenceSpData, GetConferenceSpResponse, GetSrsData, GetSrsResponse, GetExpandedSrsData, GetExpandedSrsResponse, GetEloData, GetEloResponse, GetFpiData, GetFpiResponse, GetRankingsData, GetRankingsError, GetRankingsResponse, GetPlaysData, GetPlaysResponse, GetPlayTypesResponse, GetPlayStatsData, GetPlayStatsResponse, GetPlayStatTypesResponse, GetCfpPlayoffData, GetCfpPlayoffError, GetCfpParticipantsData, GetCfpParticipantsError, GetCfpParticipantsResponse, GetCfpGamesData, GetCfpGamesError, GetCfpGamesResponse, SearchPlayersData, SearchPlayersResponse, GetPlayerUsageData, GetPlayerUsageResponse, GetPlayerSeasonOverviewData, GetReturningProductionData, GetReturningProductionResponse, GetTransferPortalData, GetTransferPortalResponse, GetPredictedPointsData, GetPredictedPointsResponse, GetPredictedPointsAddedByTeamData, GetPredictedPointsAddedByTeamResponse, GetPredictedPointsAddedByGameData, GetPredictedPointsAddedByGameResponse, GetPredictedPointsAddedByPlayerGameData, GetPredictedPointsAddedByPlayerGameResponse, GetPredictedPointsAddedByPlayerSeasonData, GetPredictedPointsAddedByPlayerSeasonResponse, GetWinProbabilityData, GetWinProbabilityResponse, GetPregameWinProbabilitiesData, GetPregameWinProbabilitiesResponse, GetFieldGoalExpectedPointsResponse, GetLivePlaysData, GetLinesData, GetLinesResponse, GetUserInfoResponse, GetUsageData, GetUsageResponse, GetGamesData, GetGamesError, GetGamesResponse, GetGameTeamStatsData, GetGameTeamStatsResponse, GetGamePlayerStatsData, GetGamePlayerStatsResponse, GetMediaData, GetMediaResponse, GetWeatherData, GetWeatherResponse, GetRecordsData, GetRecordsResponse, GetCalendarData, GetCalendarResponse, GetScoreboardData, GetScoreboardResponse, GetDrivesData, GetDrivesResponse, GetDraftTeamsResponse, GetDraftPositionsResponse, GetDraftPicksData, GetDraftPicksResponse, GetCoachesData, GetCoachesResponse, GetCoachProfileData, GetCoachProfileError, GetCoachSeasonsData, GetCoachSeasonsError, GetCoachSeasonsResponse, GetCoachTenuresData, GetCoachTenuresError, GetCoachTenuresResponse, GetAdvancedBoxScoreData } from './types.gen';
 export declare const client: import("@hey-api/client-fetch").Client<Request, Response, unknown, import("@hey-api/client-fetch").RequestOptions<boolean, string>>;
 /**
  * Retrieve opponent-adjusted team season statistics
@@ -269,6 +269,19 @@ export declare const getDraftPicks: <ThrowOnError extends boolean = false>(optio
  * Retrieves historical head coach information and records
  */
 export declare const getCoaches: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetCoachesData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetCoachesResponse, unknown, ThrowOnError>;
+/**
+ * Retrieves canonical coach identity and complete career totals
+ */
+export declare const getCoachProfile: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetCoachProfileData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<import("./types.gen").CoachProfile, GetCoachProfileError, ThrowOnError>;
+/**
+ * Retrieves detailed coach-season records with attributed results and
+ * whole-team season context
+ */
+export declare const getCoachSeasons: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetCoachSeasonsData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetCoachSeasonsResponse, GetCoachSeasonsError, ThrowOnError>;
+/**
+ * Retrieves continuous head-coaching stints and attributed records
+ */
+export declare const getCoachTenures: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetCoachTenuresData, ThrowOnError>) => import("@hey-api/client-fetch").RequestResult<GetCoachTenuresResponse, GetCoachTenuresError, ThrowOnError>;
 /**
  * Retrieves an advanced box score for a game
  */

package/dist/sdk.gen.js

@@ -13,7 +13,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPregameWinProbabilities = exports.getWinProbability = exports.getPredictedPointsAddedByPlayerSeason = exports.getPredictedPointsAddedByPlayerGame = exports.getPredictedPointsAddedByGame = exports.getPredictedPointsAddedByTeam = exports.getPredictedPoints = exports.getTransferPortal = exports.getReturningProduction = exports.getPlayerSeasonOverview = exports.getPlayerUsage = exports.searchPlayers = exports.getCfpGames = exports.getCfpParticipants = exports.getCfpPlayoff = exports.getPlayStatTypes = exports.getPlayStats = exports.getPlayTypes = exports.getPlays = exports.getRankings = exports.getFpi = exports.getElo = exports.getExpandedSrs = exports.getSrs = exports.getConferenceSp = exports.getSp = exports.getAggregatedTeamRecruitingRatings = exports.getTeamRecruitingRankings = exports.getRecruits = exports.getGameHavocStats = exports.getAdvancedGameStats = exports.getAdvancedSeasonStats = exports.getCategories = exports.getTeamStats = exports.getPlayerGameSuccessRates = exports.getPlayerSeasonSuccessRates = exports.getPlayerSeasonStats = exports.getVenues = exports.getTalent = exports.getConferences = exports.getRoster = exports.getTeamsAts = exports.getMatchup = exports.getFbsTeams = exports.getTeams = exports.getKickerPaar = exports.getAdjustedPlayerRushingStats = exports.getAdjustedPlayerPassingStats = exports.getAdjustedTeamSeasonStats = exports.client = void 0;
-exports.getAdvancedBoxScore = exports.getCoaches = exports.getDraftPicks = exports.getDraftPositions = exports.getDraftTeams = exports.getDrives = exports.getScoreboard = exports.getCalendar = exports.getRecords = exports.getWeather = exports.getMedia = exports.getGamePlayerStats = exports.getGameTeamStats = exports.getGames = exports.getUsage = exports.getUserInfo = exports.getLines = exports.getLivePlays = exports.getFieldGoalExpectedPoints = void 0;
+exports.getAdvancedBoxScore = exports.getCoachTenures = exports.getCoachSeasons = exports.getCoachProfile = exports.getCoaches = exports.getDraftPicks = exports.getDraftPositions = exports.getDraftTeams = exports.getDrives = exports.getScoreboard = exports.getCalendar = exports.getRecords = exports.getWeather = exports.getMedia = exports.getGamePlayerStats = exports.getGameTeamStats = exports.getGames = exports.getUsage = exports.getUserInfo = exports.getLines = exports.getLivePlays = exports.getFieldGoalExpectedPoints = void 0;
 var client_fetch_1 = require("@hey-api/client-fetch");
 exports.client = (0, client_fetch_1.createClient)((0, client_fetch_1.createConfig)({ baseUrl: 'https://api.collegefootballdata.com' }));
 /**
@@ -552,6 +552,31 @@ var getCoaches = function (options) {
     return ((_a = options === null || options === void 0 ? void 0 : options.client) !== null && _a !== void 0 ? _a : exports.client).get(__assign(__assign({}, options), { url: '/coaches' }));
 };
 exports.getCoaches = getCoaches;
+/**
+ * Retrieves canonical coach identity and complete career totals
+ */
+var getCoachProfile = function (options) {
+    var _a;
+    return ((_a = options === null || options === void 0 ? void 0 : options.client) !== null && _a !== void 0 ? _a : exports.client).get(__assign(__assign({}, options), { url: '/coaches/profile' }));
+};
+exports.getCoachProfile = getCoachProfile;
+/**
+ * Retrieves detailed coach-season records with attributed results and
+ * whole-team season context
+ */
+var getCoachSeasons = function (options) {
+    var _a;
+    return ((_a = options === null || options === void 0 ? void 0 : options.client) !== null && _a !== void 0 ? _a : exports.client).get(__assign(__assign({}, options), { url: '/coaches/seasons' }));
+};
+exports.getCoachSeasons = getCoachSeasons;
+/**
+ * Retrieves continuous head-coaching stints and attributed records
+ */
+var getCoachTenures = function (options) {
+    var _a;
+    return ((_a = options === null || options === void 0 ? void 0 : options.client) !== null && _a !== void 0 ? _a : exports.client).get(__assign(__assign({}, options), { url: '/coaches/tenures' }));
+};
+exports.getCoachTenures = getCoachTenures;
 /**
  * Retrieves an advanced box score for a game
  */

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;
@@ -1181,8 +1326,8 @@ export type Recruit = {
     position: (string) | null;
     height: (number) | null;
     weight: (number) | null;
-    stars: number;
-    rating: number;
+    stars: (number) | null;
+    rating: (number) | null;
     city: (string) | null;
     stateProvince: (string) | null;
     country: (string) | null;
@@ -3033,6 +3178,70 @@ export type GetCoachesData = {
 };
 export type GetCoachesResponse = (Array<Coach>);
 export type GetCoachesError = unknown;
+export type GetCoachProfileData = {
+    query: {
+        /**
+         * Required coach ID
+         */
+        coachId: number;
+    };
+};
+export type GetCoachProfileResponse = (CoachProfile);
+export type GetCoachProfileError = ({
+    message: string;
+} | CoachNotFound);
+export type GetCoachSeasonsData = {
+    query?: {
+        /**
+         * Optional coach ID
+         */
+        coachId?: number;
+        /**
+         * Optional end year range filter
+         */
+        maxYear?: number;
+        /**
+         * Optional start year range filter
+         */
+        minYear?: number;
+        /**
+         * Optional team filter
+         */
+        team?: string;
+        /**
+         * Optional exact season year
+         */
+        year?: number;
+    };
+};
+export type GetCoachSeasonsResponse = (Array<DetailedCoachSeason>);
+export type GetCoachSeasonsError = ({
+    message: string;
+});
+export type GetCoachTenuresData = {
+    query?: {
+        /**
+         * Optional active-tenure filter
+         */
+        active?: boolean;
+        /**
+         * Optional coach ID
+         */
+        coachId?: number;
+        /**
+         * Optional team filter
+         */
+        team?: string;
+        /**
+         * Optional season year contained by the tenure
+         */
+        year?: number;
+    };
+};
+export type GetCoachTenuresResponse = (Array<CoachTenure>);
+export type GetCoachTenuresError = ({
+    message: string;
+});
 export type GetAdvancedBoxScoreData = {
     query: {
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cfbd",
-  "version": "5.20.0",
+  "version": "5.21.0",
   "description": "This API is in limited Beta for Patreon subscribers. It may have bugs and is subject to changes. API keys can be acquired from the CollegeFootballData.com website.",
   "repository": {
     "type": "git",

package/src/sdk.gen.ts

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
 import { createClient, createConfig, type OptionsLegacyParser } from '@hey-api/client-fetch';
-import type { GetAdjustedTeamSeasonStatsData, GetAdjustedTeamSeasonStatsError, GetAdjustedTeamSeasonStatsResponse, GetAdjustedPlayerPassingStatsData, GetAdjustedPlayerPassingStatsError, GetAdjustedPlayerPassingStatsResponse, GetAdjustedPlayerRushingStatsData, GetAdjustedPlayerRushingStatsError, GetAdjustedPlayerRushingStatsResponse, GetKickerPaarData, GetKickerPaarError, GetKickerPaarResponse, GetTeamsData, GetTeamsError, GetTeamsResponse, GetFbsTeamsData, GetFbsTeamsError, GetFbsTeamsResponse, GetMatchupData, GetMatchupError, GetMatchupResponse, GetTeamsAtsData, GetTeamsAtsError, GetTeamsAtsResponse, GetRosterData, GetRosterError, GetRosterResponse, GetConferencesError, GetConferencesResponse, GetTalentData, GetTalentError, GetTalentResponse, GetVenuesError, GetVenuesResponse, GetPlayerSeasonStatsData, GetPlayerSeasonStatsError, GetPlayerSeasonStatsResponse, GetPlayerSeasonSuccessRatesData, GetPlayerSeasonSuccessRatesError, GetPlayerSeasonSuccessRatesResponse, GetPlayerGameSuccessRatesData, GetPlayerGameSuccessRatesError, GetPlayerGameSuccessRatesResponse, GetTeamStatsData, GetTeamStatsError, GetTeamStatsResponse, GetCategoriesError, GetCategoriesResponse, GetAdvancedSeasonStatsData, GetAdvancedSeasonStatsError, GetAdvancedSeasonStatsResponse, GetAdvancedGameStatsData, GetAdvancedGameStatsError, GetAdvancedGameStatsResponse, GetGameHavocStatsData, GetGameHavocStatsError, GetGameHavocStatsResponse, GetRecruitsData, GetRecruitsError, GetRecruitsResponse, GetTeamRecruitingRankingsData, GetTeamRecruitingRankingsError, GetTeamRecruitingRankingsResponse, GetAggregatedTeamRecruitingRatingsData, GetAggregatedTeamRecruitingRatingsError, GetAggregatedTeamRecruitingRatingsResponse, GetSpData, GetSpError, GetSpResponse, GetConferenceSpData, GetConferenceSpError, GetConferenceSpResponse, GetSrsData, GetSrsError, GetSrsResponse, GetExpandedSrsData, GetExpandedSrsError, GetExpandedSrsResponse, GetEloData, GetEloError, GetEloResponse, GetFpiData, GetFpiError, GetFpiResponse, GetRankingsData, GetRankingsError, GetRankingsResponse, GetPlaysData, GetPlaysError, GetPlaysResponse, GetPlayTypesError, GetPlayTypesResponse, GetPlayStatsData, GetPlayStatsError, GetPlayStatsResponse, GetPlayStatTypesError, GetPlayStatTypesResponse, GetCfpPlayoffData, GetCfpPlayoffError, GetCfpPlayoffResponse, GetCfpParticipantsData, GetCfpParticipantsError, GetCfpParticipantsResponse, GetCfpGamesData, GetCfpGamesError, GetCfpGamesResponse, SearchPlayersData, SearchPlayersError, SearchPlayersResponse, GetPlayerUsageData, GetPlayerUsageError, GetPlayerUsageResponse, GetPlayerSeasonOverviewData, GetPlayerSeasonOverviewError, GetPlayerSeasonOverviewResponse, GetReturningProductionData, GetReturningProductionError, GetReturningProductionResponse, GetTransferPortalData, GetTransferPortalError, GetTransferPortalResponse, GetPredictedPointsData, GetPredictedPointsError, GetPredictedPointsResponse, GetPredictedPointsAddedByTeamData, GetPredictedPointsAddedByTeamError, GetPredictedPointsAddedByTeamResponse, GetPredictedPointsAddedByGameData, GetPredictedPointsAddedByGameError, GetPredictedPointsAddedByGameResponse, GetPredictedPointsAddedByPlayerGameData, GetPredictedPointsAddedByPlayerGameError, GetPredictedPointsAddedByPlayerGameResponse, GetPredictedPointsAddedByPlayerSeasonData, GetPredictedPointsAddedByPlayerSeasonError, GetPredictedPointsAddedByPlayerSeasonResponse, GetWinProbabilityData, GetWinProbabilityError, GetWinProbabilityResponse, GetPregameWinProbabilitiesData, GetPregameWinProbabilitiesError, GetPregameWinProbabilitiesResponse, GetFieldGoalExpectedPointsError, GetFieldGoalExpectedPointsResponse, GetLivePlaysData, GetLivePlaysError, GetLivePlaysResponse, GetLinesData, GetLinesError, GetLinesResponse, GetUserInfoError, GetUserInfoResponse, GetUsageData, GetUsageError, GetUsageResponse, GetGamesData, GetGamesError, GetGamesResponse, GetGameTeamStatsData, GetGameTeamStatsError, GetGameTeamStatsResponse, GetGamePlayerStatsData, GetGamePlayerStatsError, GetGamePlayerStatsResponse, GetMediaData, GetMediaError, GetMediaResponse, GetWeatherData, GetWeatherError, GetWeatherResponse, GetRecordsData, GetRecordsError, GetRecordsResponse, GetCalendarData, GetCalendarError, GetCalendarResponse, GetScoreboardData, GetScoreboardError, GetScoreboardResponse, GetDrivesData, GetDrivesError, GetDrivesResponse, GetDraftTeamsError, GetDraftTeamsResponse, GetDraftPositionsError, GetDraftPositionsResponse, GetDraftPicksData, GetDraftPicksError, GetDraftPicksResponse, GetCoachesData, GetCoachesError, GetCoachesResponse, GetAdvancedBoxScoreData, GetAdvancedBoxScoreError, GetAdvancedBoxScoreResponse } from './types.gen';
+import type { GetAdjustedTeamSeasonStatsData, GetAdjustedTeamSeasonStatsError, GetAdjustedTeamSeasonStatsResponse, GetAdjustedPlayerPassingStatsData, GetAdjustedPlayerPassingStatsError, GetAdjustedPlayerPassingStatsResponse, GetAdjustedPlayerRushingStatsData, GetAdjustedPlayerRushingStatsError, GetAdjustedPlayerRushingStatsResponse, GetKickerPaarData, GetKickerPaarError, GetKickerPaarResponse, GetTeamsData, GetTeamsError, GetTeamsResponse, GetFbsTeamsData, GetFbsTeamsError, GetFbsTeamsResponse, GetMatchupData, GetMatchupError, GetMatchupResponse, GetTeamsAtsData, GetTeamsAtsError, GetTeamsAtsResponse, GetRosterData, GetRosterError, GetRosterResponse, GetConferencesError, GetConferencesResponse, GetTalentData, GetTalentError, GetTalentResponse, GetVenuesError, GetVenuesResponse, GetPlayerSeasonStatsData, GetPlayerSeasonStatsError, GetPlayerSeasonStatsResponse, GetPlayerSeasonSuccessRatesData, GetPlayerSeasonSuccessRatesError, GetPlayerSeasonSuccessRatesResponse, GetPlayerGameSuccessRatesData, GetPlayerGameSuccessRatesError, GetPlayerGameSuccessRatesResponse, GetTeamStatsData, GetTeamStatsError, GetTeamStatsResponse, GetCategoriesError, GetCategoriesResponse, GetAdvancedSeasonStatsData, GetAdvancedSeasonStatsError, GetAdvancedSeasonStatsResponse, GetAdvancedGameStatsData, GetAdvancedGameStatsError, GetAdvancedGameStatsResponse, GetGameHavocStatsData, GetGameHavocStatsError, GetGameHavocStatsResponse, GetRecruitsData, GetRecruitsError, GetRecruitsResponse, GetTeamRecruitingRankingsData, GetTeamRecruitingRankingsError, GetTeamRecruitingRankingsResponse, GetAggregatedTeamRecruitingRatingsData, GetAggregatedTeamRecruitingRatingsError, GetAggregatedTeamRecruitingRatingsResponse, GetSpData, GetSpError, GetSpResponse, GetConferenceSpData, GetConferenceSpError, GetConferenceSpResponse, GetSrsData, GetSrsError, GetSrsResponse, GetExpandedSrsData, GetExpandedSrsError, GetExpandedSrsResponse, GetEloData, GetEloError, GetEloResponse, GetFpiData, GetFpiError, GetFpiResponse, GetRankingsData, GetRankingsError, GetRankingsResponse, GetPlaysData, GetPlaysError, GetPlaysResponse, GetPlayTypesError, GetPlayTypesResponse, GetPlayStatsData, GetPlayStatsError, GetPlayStatsResponse, GetPlayStatTypesError, GetPlayStatTypesResponse, GetCfpPlayoffData, GetCfpPlayoffError, GetCfpPlayoffResponse, GetCfpParticipantsData, GetCfpParticipantsError, GetCfpParticipantsResponse, GetCfpGamesData, GetCfpGamesError, GetCfpGamesResponse, SearchPlayersData, SearchPlayersError, SearchPlayersResponse, GetPlayerUsageData, GetPlayerUsageError, GetPlayerUsageResponse, GetPlayerSeasonOverviewData, GetPlayerSeasonOverviewError, GetPlayerSeasonOverviewResponse, GetReturningProductionData, GetReturningProductionError, GetReturningProductionResponse, GetTransferPortalData, GetTransferPortalError, GetTransferPortalResponse, GetPredictedPointsData, GetPredictedPointsError, GetPredictedPointsResponse, GetPredictedPointsAddedByTeamData, GetPredictedPointsAddedByTeamError, GetPredictedPointsAddedByTeamResponse, GetPredictedPointsAddedByGameData, GetPredictedPointsAddedByGameError, GetPredictedPointsAddedByGameResponse, GetPredictedPointsAddedByPlayerGameData, GetPredictedPointsAddedByPlayerGameError, GetPredictedPointsAddedByPlayerGameResponse, GetPredictedPointsAddedByPlayerSeasonData, GetPredictedPointsAddedByPlayerSeasonError, GetPredictedPointsAddedByPlayerSeasonResponse, GetWinProbabilityData, GetWinProbabilityError, GetWinProbabilityResponse, GetPregameWinProbabilitiesData, GetPregameWinProbabilitiesError, GetPregameWinProbabilitiesResponse, GetFieldGoalExpectedPointsError, GetFieldGoalExpectedPointsResponse, GetLivePlaysData, GetLivePlaysError, GetLivePlaysResponse, GetLinesData, GetLinesError, GetLinesResponse, GetUserInfoError, GetUserInfoResponse, GetUsageData, GetUsageError, GetUsageResponse, GetGamesData, GetGamesError, GetGamesResponse, GetGameTeamStatsData, GetGameTeamStatsError, GetGameTeamStatsResponse, GetGamePlayerStatsData, GetGamePlayerStatsError, GetGamePlayerStatsResponse, GetMediaData, GetMediaError, GetMediaResponse, GetWeatherData, GetWeatherError, GetWeatherResponse, GetRecordsData, GetRecordsError, GetRecordsResponse, GetCalendarData, GetCalendarError, GetCalendarResponse, GetScoreboardData, GetScoreboardError, GetScoreboardResponse, GetDrivesData, GetDrivesError, GetDrivesResponse, GetDraftTeamsError, GetDraftTeamsResponse, GetDraftPositionsError, GetDraftPositionsResponse, GetDraftPicksData, GetDraftPicksError, GetDraftPicksResponse, GetCoachesData, GetCoachesError, GetCoachesResponse, GetCoachProfileData, GetCoachProfileError, GetCoachProfileResponse, GetCoachSeasonsData, GetCoachSeasonsError, GetCoachSeasonsResponse, GetCoachTenuresData, GetCoachTenuresError, GetCoachTenuresResponse, GetAdvancedBoxScoreData, GetAdvancedBoxScoreError, GetAdvancedBoxScoreResponse } from './types.gen';
 
 export const client = createClient(createConfig({ baseUrl: 'https://api.collegefootballdata.com' }));
 
@@ -675,6 +675,37 @@ export const getCoaches = <ThrowOnError extends boolean = false>(options?: Optio
     });
 };
 
+/**
+ * Retrieves canonical coach identity and complete career totals
+ */
+export const getCoachProfile = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetCoachProfileData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetCoachProfileResponse, GetCoachProfileError, ThrowOnError>({
+        ...options,
+        url: '/coaches/profile'
+    });
+};
+
+/**
+ * Retrieves detailed coach-season records with attributed results and
+ * whole-team season context
+ */
+export const getCoachSeasons = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetCoachSeasonsData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetCoachSeasonsResponse, GetCoachSeasonsError, ThrowOnError>({
+        ...options,
+        url: '/coaches/seasons'
+    });
+};
+
+/**
+ * Retrieves continuous head-coaching stints and attributed records
+ */
+export const getCoachTenures = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetCoachTenuresData, ThrowOnError>) => {
+    return (options?.client ?? client).get<GetCoachTenuresResponse, GetCoachTenuresError, ThrowOnError>({
+        ...options,
+        url: '/coaches/tenures'
+    });
+};
+
 /**
  * Retrieves an advanced box score for a game
  */

package/src/types.gen.ts

@@ -311,6 +311,8 @@ export type CalendarWeek = {
     lastGameStart: string;
 };
 
+export type CfpCoachSeasonOutcome = 'active' | 'eliminated' | 'champion';
+
 export type CfpPlayoff = {
     season: number;
     competition: PlayoffCompetition_Cfp;
@@ -329,19 +331,129 @@ 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;
@@ -350,6 +462,33 @@ export type CoachSeason = {
     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;
@@ -394,6 +533,31 @@ export type ConferenceSP = {
     };
 };
 
+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 = {
@@ -1275,8 +1439,8 @@ export type Recruit = {
     position: (string) | null;
     height: (number) | null;
     weight: (number) | null;
-    stars: number;
-    rating: number;
+    stars: (number) | null;
+    rating: (number) | null;
     city: (string) | null;
     stateProvince: (string) | null;
     country: (string) | null;
@@ -3357,6 +3521,79 @@ export type GetCoachesResponse = (Array<Coach>);
 
 export type GetCoachesError = unknown;
 
+export type GetCoachProfileData = {
+    query: {
+        /**
+         * Required coach ID
+         */
+        coachId: number;
+    };
+};
+
+export type GetCoachProfileResponse = (CoachProfile);
+
+export type GetCoachProfileError = ({
+    message: string;
+} | CoachNotFound);
+
+export type GetCoachSeasonsData = {
+    query?: {
+        /**
+         * Optional coach ID
+         */
+        coachId?: number;
+        /**
+         * Optional end year range filter
+         */
+        maxYear?: number;
+        /**
+         * Optional start year range filter
+         */
+        minYear?: number;
+        /**
+         * Optional team filter
+         */
+        team?: string;
+        /**
+         * Optional exact season year
+         */
+        year?: number;
+    };
+};
+
+export type GetCoachSeasonsResponse = (Array<DetailedCoachSeason>);
+
+export type GetCoachSeasonsError = ({
+    message: string;
+});
+
+export type GetCoachTenuresData = {
+    query?: {
+        /**
+         * Optional active-tenure filter
+         */
+        active?: boolean;
+        /**
+         * Optional coach ID
+         */
+        coachId?: number;
+        /**
+         * Optional team filter
+         */
+        team?: string;
+        /**
+         * Optional season year contained by the tenure
+         */
+        year?: number;
+    };
+};
+
+export type GetCoachTenuresResponse = (Array<CoachTenure>);
+
+export type GetCoachTenuresError = ({
+    message: string;
+});
+
 export type GetAdvancedBoxScoreData = {
     query: {
         /**