--- title: "Betting Events - by Season" method: GET path: "/v3/cbb/odds/{format}/BettingEvents/{season}" tags: ["CBB v3 Odds"] --- # Betting Events - by Season `GET /v3/cbb/odds/{format}/BettingEvents/{season}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/cbb/odds/{format}/BettingEvents/{season}` - 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 season, 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 - `season` string, required ## Response `200` Success - BettingEvent[] - `BettingEventID` integer: The unique ID associated with the betting event - `Name` string, nullable: The name of this betting event - `Season` integer, nullable: The season that this betting event occurs in. Note: season is a single year that the majority of the season occurs in - `BettingEventTypeID` integer: The ID associated with the type of betting event - `BettingEventType` string, nullable: Indicates the type of betting event (Game or Future) - `StartDate` string, nullable: The date and time a specified event is scheduled to begin. Note: For Futures, this will be the furthest forward time a book has a market set to close - `Created` string, nullable: The date and time when this betting event was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting event was updated (in 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. This value is guaranteed to be unique across all sports/leagues - `GameStatus` string, nullable: The status of the game in tied to this event. A list of CBB game statuses can be found here - `AwayTeam` string, nullable: The abbreviation [Key] of the away team tied to the event - `HomeTeam` string, nullable: The abbreviation [Key] of the home team tied to this event - `AwayTeamID` integer, nullable: The unique ID of the away team tied to the event - `HomeTeamID` integer, nullable: The unique ID of the home team tied to this event - `GlobalAwayTeamID` integer, nullable: A globally unique ID for the away team tied to this event This value is guaranteed to be unique across all sports/leagues - `GlobalHomeTeamID` integer, nullable: A globally unique ID for the home team tied to this event. This value is guaranteed to be unique across all sports/leagues - `AwayTeamScore` integer, nullable: Total number of points the away team scored in the game tied to the event (post-game) - `HomeTeamScore` integer, nullable: Total number of points the home team scored in this game (post-game) - `TotalScore` integer, nullable: The total amount of points scored in the game by both teams, posted after the conclusion of the game - `AwayRotationNumber` integer, nullable: Rotation number of away team in the game tied to this event. - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game for this event - `BettingMarkets` BettingMarket[]: The list of betting markets for this event - `BettingMarketID` integer: The unique identifier of this betting market - `BettingEventID` integer: The unique ID associated with the betting market - `BettingMarketTypeID` integer, nullable: The unique ID associated with this type of betting market - `BettingMarketType` string, nullable: The name of the market type (e.g. Player Prop, Team Prop, Game Prop, etc.) - `BettingBetTypeID` integer, nullable: The unique ID associated with the betting event - `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 market - `BettingPeriodType` string, nullable: The BettingPeriodType of this market (e.g. Full Game; 1st Half; 2nd Quarter; Regular Season) - `Name` string, nullable: The generic name of this market - `TeamID` integer, nullable: The unique ID of the team (if applicable) - `TeamKey` string, nullable: The abbreviation [Key] of the team tied to this market (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (if applicable). Note: this ID will stay with the player throughout their collegiate career - `PlayerName` string, nullable: The full name of the player associated with this market (if applicable) - `Created` string, nullable: The date and time when this betting market was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting market was updated (in US Eastern Time) - `AvailableSportsbooks` Sportsbook[]: A list of sportsbooks that have odds available in a given market - `SportsbookID` integer: The unique ID associated with this sportsbook - `Name` string, nullable: The name of the sportsbook - `AnyBetsAvailable` boolean, nullable: A field that returns "Yes" if there are any available bets to make within the market in question. If there are no bets available to make, the field returns "No" - `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 associated with this sportsbook - `Name` string, nullable: The name of the sportsbook - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: The name of betting outcome type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The payout of the bet, shown in American odds format - `PayoutDecimal` number, nullable: The payout of the bet, shown in Decimal odds format - `Value` number, nullable: The number associated with the outcome of a market (e.g. the spread, game total, etc.) - `Participant` string, nullable: The name of the participant (typically a team or player) associated with a given 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: Indicates whether a BettingOutcome is available for betting or not - `IsAlternate` boolean, nullable: Is this an alternate value or the core value - `Created` string, nullable: The date and time when this betting outcome was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting outcome was updated (in US Eastern Time) - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further - `TeamID` integer, nullable: The unique ID of the team (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (if applicable). Note: this ID will stay with the player throughout their collegiate career - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues (where applicable) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `IsInPlay` boolean, nullable: Was this outcome created after the start time of the game (only applies when the betting event is of type game) - `SportsbookMarketID` string, nullable: The market ID from the given sportsbook when available - `SportsbookOutcomeID` string, nullable: The outcome ID from the given sportsbook when available - `ConsensusOutcomes` ConsensusOutcome[]: The single set of consensus 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 associated with this sportsbook - `Name` string, nullable: The name of the sportsbook - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: The name of betting outcome type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The payout of the bet, shown in American odds format - `PayoutDecimal` number, nullable: The payout of the bet, shown in Decimal odds format - `Value` number, nullable: The number associated with the outcome of a market (e.g. the spread, game total, etc.) - `Participant` string, nullable: The name of the participant (typically a team or player) associated with a given 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: Indicates whether a BettingOutcome is available for betting or not - `IsAlternate` boolean, nullable: Is this an alternate value or the core value - `Created` string, nullable: The date and time when this betting outcome was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting outcome was updated (in US Eastern Time) - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further - `TeamID` integer, nullable: The unique ID of the team (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (if applicable). Note: this ID will stay with the player throughout their collegiate career - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues (where applicable) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `IsInPlay` boolean, nullable: Was this outcome created after the start time of the game (only applies when the betting event is of type game) - `SportsbookMarketID` string, nullable: The market ID from the given sportsbook when available - `SportsbookOutcomeID` string, nullable: The outcome ID from the given sportsbook when available - `IsArchived` boolean: Indicates whether a BettingOutcome has been archived or not. If Archived, that outcome is no longer available - `ArchiveLocation` string, nullable: Indicates the URL that can be used to retrieve archived BettingOutcomes. An API Key and Sportsbook Grouping will be required to retrieve this information - `GameStartTime` string, nullable: The date and time that the game started. Note: Time is in US Eastern Time ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/cbb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cbb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cbb-api/revisions/2bf9419ae396?raw)