--- title: "Betting Player Props - by Game" method: GET path: "/v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}" tags: ["MLB v3 Odds"] --- # Betting Player Props - by Game `GET /v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/mlb/odds/{format}/BettingPlayerPropsByGameID/{gameId}` - 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) This works in the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only. Ideal if your application will only ever require Player Props, but if you also want Team Props etc. it is recommended to use the by Market Type endpoint. ## Path parameters - `format` 'JSON' | 'XML', required - `gameId` string, required ## Query parameters - `include` 'available' | 'unlisted' ## Response `200` Success - BettingMarket[] - `BettingMarketID` integer: The unique ID associated with the betting market - `BettingEventID` integer: The unique ID assocated with the betting event - `BettingMarketTypeID` integer, nullable: The unique ID associated with the market type of the betting market - `BettingMarketType` string, nullable: The name of the market type within a market (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 Runs, Moneyline, Run Line, etc.) - `BettingPeriodTypeID` integer, nullable: The BettingPeriodTypeID of this market - `BettingPeriodType` string, nullable: The BettingPeriodType of this market (e.g. Full Game; 1st-5th Inning; 2nd Inning; Regular Season) - `Name` string, nullable: The generic name of this market - `TeamID` integer, nullable: The team's unique TeamID as assigned by SportsDataIO tied this market (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 tied to this market (if applicable) Note: this ID will stay with the player throughout their MLB career - `PlayerName` string, nullable: The full name of the player associated with this market - `Created` string, nullable: The date and time when this betting market was created in US Eastern Time - `Updated` string, nullable: The date and time of the last update made to this betting market (in US Eastern Time) - `AvailableSportsbooks` Sportsbook[]: The sportsbooks that have had odds in this market - `SportsbookID` integer: Unique ID of the sportsbook - `Name` string, nullable: The name of the sportsbook(s) - `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 the betting outcome - `BettingMarketID` integer, nullable: The unique ID associated with the betting market - `SportsBook` Sportsbook - `SportsbookID` integer: Unique ID of the sportsbook - `Name` string, nullable: The name of the sportsbook(s) - `BettingOutcomeTypeID` integer, nullable: The unique ID associated with this BettingOutcomeType - `BettingOutcomeType` string, nullable: The name of BettingOutcomeType (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 run line, game 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: Indicates whether a BettingOutcome is available for betting or not (true/false) - `IsAlternate` boolean, nullable: Indicates whether this is an alternate value or the core value (true/false) - `Created` string, nullable: The date and time when this betting outcome was created in US Eastern Time. - `Updated` string, nullable: The date and time of the last update made to this betting outcome (in US Eastern Time) - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (In US Eastern Time) - `TeamID` integer, nullable: The team's unique TeamID as assigned by SportsDataIO tied this outcome (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO tied to this outcome (if applicable) Note: this ID will stay with the player throughout their MLB career - `GlobalTeamID` integer, nullable: A globally unique ID for this team tied to this outcome. 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; true/false) - `SportsbookMarketID` string, nullable: The market ID on the given sportsbook for deeplinking (when available) - `SportsbookOutcomeID` string, nullable: The outcome ID on the given sportsbook for deeplinking (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 the betting outcome - `BettingMarketID` integer, nullable: The unique ID associated with the betting market - `SportsBook` Sportsbook - `SportsbookID` integer: Unique ID of the sportsbook - `Name` string, nullable: The name of the sportsbook(s) - `BettingOutcomeTypeID` integer, nullable: The unique ID associated with this BettingOutcomeType - `BettingOutcomeType` string, nullable: The name of BettingOutcomeType (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 run line, game 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: Indicates whether a BettingOutcome is available for betting or not (true/false) - `IsAlternate` boolean, nullable: Indicates whether this is an alternate value or the core value (true/false) - `Created` string, nullable: The date and time when this betting outcome was created in US Eastern Time. - `Updated` string, nullable: The date and time of the last update made to this betting outcome (in US Eastern Time) - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (In US Eastern Time) - `TeamID` integer, nullable: The team's unique TeamID as assigned by SportsDataIO tied this outcome (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO tied to this outcome (if applicable) Note: this ID will stay with the player throughout their MLB career - `GlobalTeamID` integer, nullable: A globally unique ID for this team tied to this outcome. 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; true/false) - `SportsbookMarketID` string, nullable: The market ID on the given sportsbook for deeplinking (when available) - `SportsbookOutcomeID` string, nullable: The outcome ID on the given sportsbook for deeplinking (when available) - `IsArchived` boolean: Indicates whether a BettingOutcome has been archived or not (true/false) - `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 ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/mlb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/mlb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/mlb-api/revisions/60fb38ac37e7?raw)