--- title: "Betting Events - by Date" method: GET path: "/v3/cfb/odds/{format}/BettingEventsByDate/{date}" tags: ["CFB v3 Odds"] --- # Betting Events - by Date `GET /v3/cfb/odds/{format}/BettingEventsByDate/{date}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/cfb/odds/{format}/BettingEventsByDate/{date}` - Auth: one of: - API key in header `Ocp-Apim-Subscription-Key` - API key in query parameter `key` - TypeScript: (a function with typed inputs; its response is checked against the schema) The list of current BettingEvents for the given date, from which Betting Market data can be gathered via the Betting Markets by Event endpoint, for all available Betting Market types (e.g. Player Props, Team Props.) ## Path parameters - `format` 'JSON' | 'XML', required - `date` string, required ## Response `200` Success - BettingEvent[] - `BettingEventID` integer: The unique ID assocated with the betting event - `Name` string, nullable: The name of this betting event - `Season` integer, nullable: The college football season of the game - `BettingEventTypeID` integer: The ID associated with the type of betting event - Game or Future - `BettingEventType` string, nullable: Indicates the type of betting event - Game or Future - `StartDate` string, nullable: The furthest forward time any book has a market set to close for this betting event - `Created` string, nullable: The created date of this betting event - `Updated` string, nullable: The last updated timestamp of this betting event (US Eastern Time) - `GameID` integer, nullable: The unique ID of this game tied to this event - `GlobalGameID` integer, nullable: A globally unique ID for this game tied to this event. Note: This value is guaranteed to be unique across all sports/leagues - `GameStatus` string, nullable: The status of the game tied to this event - `AwayTeam` string, nullable: The abbreviation [Key] of the away team tied to this event - `HomeTeam` string, nullable: The abbreviation [Key] of the home team - `AwayTeamID` integer, nullable: The unique ID of the away team tied to this event - `HomeTeamID` integer, nullable: The unique ID of the home team - `GlobalAwayTeamID` integer, nullable: A globally unique ID for the away team tied this event. Note: This value is guaranteed to be unique across all sports/leagues - `GlobalHomeTeamID` integer, nullable: A globally unique ID for the home team. Note: This value is guaranteed to be unique across all sports/leagues - `AwayTeamScore` integer, nullable: The away team score of the game tied to this event (post-game) - `HomeTeamScore` integer, nullable: The home team score of the game tied to this event (postgame) - `TotalScore` integer, nullable: The total points scored by both teams in the game tied to this event (updated after game ends to allow for resolving bets) - `AwayRotationNumber` integer, nullable: The away team rotation number of the game tied to this event - `HomeRotationNumber` integer, nullable: Rotation number of home team tied to this event - `BettingMarkets` BettingMarket[]: The list of betting markets for this event - `BettingMarketID` integer: The unique ID associated with the betting market - `BettingEventID` integer: The unique ID assocated with the betting event - `BettingMarketTypeID` integer, nullable: ID that distinguishes the different types of Market Types - `BettingMarketType` string, nullable: The type of Market Type (e.g. Player Prop, Team Prop, Game Prop, etc.) - `BettingBetTypeID` integer, nullable: The ID associated with the name of the bet type within a market - `BettingBetType` string, nullable: The name of the bet type within a market (e.g. Total Points, Moneyline, Spread, etc.) - `BettingPeriodTypeID` integer, nullable: The BettingPeriodTypeID of this type of market which we can result - `BettingPeriodType` string, nullable: The BettingPeriodType of this market (e.g. Full Game; 1st Quarter; Overtime; Regular Season) - `Name` string, nullable: The generic name of this market - `TeamID` integer, nullable: The unique ID of the team associated with this betting market - `TeamKey` string, nullable: The key of the team tied to this market (if applicable) - `PlayerID` integer, nullable: The unique ID of the player as assigned by SportsDataIO tied this market (if applicable). Note: this ID remains with the player their entire collegiate career - `PlayerName` string, nullable: The name of the player tied to this market (if applicable) - `Created` string, nullable: The created date of this market - `Updated` string, nullable: The last updated timestamp of this market (US Eastern Time) - `AvailableSportsbooks` Sportsbook[]: The sportsbooks that have published odds within this market - `SportsbookID` integer: The unique ID of the sportsbook - `Name` string, nullable: The name of the sportsbooks - `AnyBetsAvailable` boolean, nullable: A field that returns "True" if there are any available bets to make within the market in question. If there are no bets available to make, the field returns "False" - `BettingOutcomes` BettingOutcome[]: The list of betting outcomes from each sportsbook in this market - `BettingOutcomeID` integer, nullable: The unique ID associated with this specific outcome - `BettingMarketID` integer, nullable: The unique ID associated with the betting market - `SportsBook` Sportsbook - `SportsbookID` integer: The unique ID of the sportsbook - `Name` string, nullable: The name of the sportsbooks - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: Name of Betting Outcome Type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The american odds payout - `PayoutDecimal` number, nullable: The decimal odds payout - `Value` number, nullable: The number associated with the outcome (spread, total, etc) - `Participant` string, nullable: The name of the participant (typically team or player) associated with the outcome. NOTE: This is provided by the sportsbook. In the case of Player odds; we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks. - `IsAvailable` boolean, nullable: Denotes whether or not the betting outcome is currently available - `IsAlternate` boolean, nullable: Denotes whether or not the betting outcome is an alternate line - `Created` string, nullable: The created date of the outcome - `Updated` string, nullable: The last updated timestamp of this outcome (US Eastern Time) - `Unlisted` string, nullable: The timestamp of when this outcome was unlisted (no longer available for bets) - `TeamID` integer, nullable: The unique ID of the team associated with this betting outcome - `PlayerID` integer, nullable: The unique ID of the player as assigned by SportsDataIO tied this outcome (if applicable). Note: this ID remains with the player their entire collegiate career - `GlobalTeamID` integer, nullable: A globally unique ID for the team tied this outcome. Note: This value is guaranteed to be unique across all sports/leagues - `SportsbookUrl` string, nullable: The URL for sportsbook event - `IsInPlay` boolean, nullable: Denotes whether the betting outcome is a live line (i.e. the outcome was created after the start of the game) - `SportsbookMarketID` string, nullable: The market ID of a given sportsbook when available for deep links - `SportsbookOutcomeID` string, nullable: The outcome ID of a given sportsbook when available for deep links - `ConsensusOutcomes` ConsensusOutcome[]: The single set of consesnus outcomes of this market - `NumberOfSportsbooks` integer: The number of sportsbooks odds that went into creating this consensus outcome - `BettingOutcomeID` integer, nullable: The unique ID associated with this specific outcome - `BettingMarketID` integer, nullable: The unique ID associated with the betting market - `SportsBook` Sportsbook - `SportsbookID` integer: The unique ID of the sportsbook - `Name` string, nullable: The name of the sportsbooks - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: Name of Betting Outcome Type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The american odds payout - `PayoutDecimal` number, nullable: The decimal odds payout - `Value` number, nullable: The number associated with the outcome (spread, total, etc) - `Participant` string, nullable: The name of the participant (typically team or player) associated with the outcome. NOTE: This is provided by the sportsbook. In the case of Player odds; we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks. - `IsAvailable` boolean, nullable: Denotes whether or not the betting outcome is currently available - `IsAlternate` boolean, nullable: Denotes whether or not the betting outcome is an alternate line - `Created` string, nullable: The created date of the outcome - `Updated` string, nullable: The last updated timestamp of this outcome (US Eastern Time) - `Unlisted` string, nullable: The timestamp of when this outcome was unlisted (no longer available for bets) - `TeamID` integer, nullable: The unique ID of the team associated with this betting outcome - `PlayerID` integer, nullable: The unique ID of the player as assigned by SportsDataIO tied this outcome (if applicable). Note: this ID remains with the player their entire collegiate career - `GlobalTeamID` integer, nullable: A globally unique ID for the team tied this outcome. Note: This value is guaranteed to be unique across all sports/leagues - `SportsbookUrl` string, nullable: The URL for sportsbook event - `IsInPlay` boolean, nullable: Denotes whether the betting outcome is a live line (i.e. the outcome was created after the start of the game) - `SportsbookMarketID` string, nullable: The market ID of a given sportsbook when available for deep links - `SportsbookOutcomeID` string, nullable: The outcome ID of a given sportsbook when available for deep links - `IsArchived` boolean: Indicates if the BettingOutcomes have been moved to the archives - `ArchiveLocation` string, nullable: If IsArchived is true, this returns the URL that can be used to retrieve the archived BettingOutcomes. An API Key and Sportsbook Grouping will be required to retrieve this information. If IsArchived is false, this returns an emtpy string - `GameStartTime` string, nullable: The date and time the connected game starts, where applicable ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/cfb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cfb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cfb-api/revisions/2937cc5c9322?raw)