---
title: "Betting Events - by Date"
method: GET
path: "/v3/nfl/odds/{format}/BettingEventsByDate/{date}"
tags: ["NFL v3 Odds"]
---

# Betting Events - by Date

`GET /v3/nfl/odds/{format}/BettingEventsByDate/{date}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/nfl/odds/{format}/BettingEventsByDate/{date}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/nfl-api/docs/v3/nfl/odds/:format/BettingEventsByDate/:date/get.ts> (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 the betting event
  - `Season` integer, nullable: The NFL season of the betting event
  - `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 furthest forward time any book has a market set to close for this betting event
  - `Created` string, nullable: The date and time when this betting event was created in US Eastern Time
  - `Updated` string, nullable: The date and time of the last update made to this betting event (in US Eastern Time)
  - `ScoreID` integer, nullable: ScoreID has been superseded by GameID and should not be used in any new integrations. Existing integrations can be updated to use GameID instead, so that they are consistent with all other sports.
  - `GlobalScoreID` integer, nullable: A globally unique ID for the game tied to this betting event. This value is guaranteed to be unique across all sports/leagues
  - `GameStatus` string, nullable: The status of the game tied to this betting event
  - `Quarter` string, nullable: The quarter of the game tied to this event
  - `AwayTeam` string, nullable: The abbreviation [Key] of the away team
  - `HomeTeam` string, nullable: The abbreviation [Key] of the Home Team
  - `AwayTeamID` integer, nullable: The unique TeamID of the away team tied to this BettingEvent
  - `HomeTeamID` integer, nullable: The unique TeamID of the home team tied to this BettingEvent
  - `GlobalAwayTeamID` integer, nullable: A globally unique ID for the away team tied to this BettingEvent 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 BettingEvent. This value is guaranteed to be unique across all sports/leagues.
  - `AwayTeamScore` integer, nullable: Score of the away team tied to this betting event (updated after game ends to allow for resolving bets)
  - `HomeTeamScore` integer, nullable: Score of the home team tied to this betting event (updated after game ends to allow for resolving bets)
  - `TotalScore` integer, nullable: The total points scored by both teams in the game tied to this event (updated after game ends to allow for resulting bets)
  - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game
  - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
  - `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: 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 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 Period; Overtime; Regular Season)
    - `Name` string, nullable: The name of the betting 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 unique PlayerID of the player as assigned by SportsDataIO tied to this betting market. Note: this ID will stay with the player throughout their entire 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 (spread, total, etc)
      - `Participant` string, nullable: This field is sourced from the related sportsbook and is shown as is; consider it as free-text that can take any form. If a BettingOutcome has the PlayerId or TeamId field set; you should use the respective Player or Team record to perform actions like displaying a player's name. Note: if a BettingMarket has PlayerId or TeamId set; all the child BettingOutcomes will have the field set as well
      - `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 unique PlayerID of the player as assigned by SportsDataIO tied to this betting outcome. Note: this ID will stay with the player throughout their entire 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 when available for deep links
      - `SportsbookOutcomeID` string, nullable: The outcome id on the given sportsbook when available for deep links
    - `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 (spread, total, etc)
      - `Participant` string, nullable: This field is sourced from the related sportsbook and is shown as is; consider it as free-text that can take any form. If a BettingOutcome has the PlayerId or TeamId field set; you should use the respective Player or Team record to perform actions like displaying a player's name. Note: if a BettingMarket has PlayerId or TeamId set; all the child BettingOutcomes will have the field set as well
      - `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 unique PlayerID of the player as assigned by SportsDataIO tied to this betting outcome. Note: this ID will stay with the player throughout their entire 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 when available for deep links
      - `SportsbookOutcomeID` string, nullable: The outcome id on the given sportsbook when available for deep links
    - `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
  - `GameStartTime` string, nullable: The date and time the game starts

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/nfl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nfl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nfl-api/revisions/2dca8b6e9675?raw)