Your web browser appears to be outdated. Our website may not look quite right in it.
Please consider using one of our preferred browsers to enjoy an optimal experience.
NFL API Documentation
This is the documentation for our NFL API. To get a more comprehensive understanding of what feeds
we have to offer and the data points we deliver via our endpoints, we encourage you to explore the following resources:
All of our API endpoints can be accessed via an HTTP GET request using your API key.
The API key can be passed either as a query parameter or using the following HTTP request header.
Ocp-Apim-Subscription-Key: {key}
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns full team information, including name, city, conference, division, colors, coaching and scheme info, fantasy IDs, and complete stadium data. Includes all teams, active or inactive
Returns full team information, including name, city, conference, division, colors, coaching and scheme info, fantasy IDs, and complete stadium data. Includes only teams currently active in the league.
Returns full team information, including name, city, conference, division, colors, coaching and scheme info, fantasy IDs, and complete stadium data. Includes teams active in the specified season.
Returns basic team information, including name, city, conference, division, stadium ID, coach details, and team colors. Includes all teams, active or inactive.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
team
string
true
Abbreviation of the team. Example: WAS.
Team Profiles - All
Returns full team information, including name, city, conference, division, colors, coaching and scheme info, fantasy IDs, and complete stadium data. Includes all teams, active or inactive
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Team Profiles - by Active
Returns full team information, including name, city, conference, division, colors, coaching and scheme info, fantasy IDs, and complete stadium data. Includes only teams currently active in the league.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Team Profiles - by Season
Returns full team information, including name, city, conference, division, colors, coaching and scheme info, fantasy IDs, and complete stadium data. Includes teams active in the specified season.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
Team Profiles (Basic) - All
Returns basic team information, including name, city, conference, division, stadium ID, coach details, and team colors. Includes all teams, active or inactive.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
Returns the year of the most recently completed NFL season. This value updates immediately after the Super Bowl. NFL seasons are identified by their start year (e.g., the 2023 season spans 2023–2024).
Returns the year of the current NFL season if in-season, or the next upcoming season if in the offseason. Updates immediately after the Super Bowl. NFL seasons are identified by their start year (e.g., the 2025 season spans 2025–2026).
Returns the number of the last completed NFL week. Typically updates on Tuesday night or Wednesday morning (ET), but may vary due to rescheduled or international games.
Returns the number of the next upcoming week. Typically updates on Tuesday night or Wednesday morning (ET), but may vary due to rescheduled or international games.
Are Games In Progress
Returns true if there is at least one game being played at the time of the request or false if there are none.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
boolean
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Betting Metadata
Returns the list of MarketTypes, BetTypes, PeriodTypes, OutcomeTypes, and ResultTypes to map the IDs to descriptive names. Also includes a list of the MarketType, BetType & PeriodType combinations which we will have resulting for.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
Season - Current
Returns the calendar year of the current season. For leagues that span across two calendar years, the current season is defined as the calendar year in which the majority of the season falls.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
Not Ideal For:
Retrieving full API season info and dates (Use Timeframes instead.)
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Season - Last Completed
Returns the year of the most recently completed NFL season. This value updates immediately after the Super Bowl. NFL seasons are identified by their start year (e.g., the 2023 season spans 2023–2024).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Season - Upcoming
Returns the year of the current NFL season if in-season, or the next upcoming season if in the offseason. Updates immediately after the Super Bowl. NFL seasons are identified by their start year (e.g., the 2025 season spans 2025–2026).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
type
string
true
current
upcoming
completed
recent
all
The type of timeframes to return. Valid entries are current or upcoming or completed or recent or all.
Week - Current
Returns the current week number. Typically updates on Tuesday night or Wednesday morning (ET), but may vary due to rescheduled or international games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Week - Last Completed
Returns the number of the last completed NFL week. Typically updates on Tuesday night or Wednesday morning (ET), but may vary due to rescheduled or international games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Week - Upcoming
Returns the number of the next upcoming week. Typically updates on Tuesday night or Wednesday morning (ET), but may vary due to rescheduled or international games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
integer?
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns game details including home and away teams, date and time, season type, week, and gameday info. Also includes full stadium information (capacity, location, surface), top-line betting info (spread, moneyline, total), weather conditions, and broadcast details.
Returns game details including home and away teams, date and time, season type, week, and gameday info. Also includes full stadium information (capacity, location, surface), top-line betting info (spread, moneyline, total), weather conditions, and broadcast details.
Populating calendar views, retrieving GameID's for a full season to link to other feeds, and static game metadata.
Not Ideal For:
Live scores and game status updates. Use Games - by Date instead.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns scores for games on the specified date. Including gameday details, weather, referee, infotainment odds, quarter-by-quarter scores, and final score.
Returns scores for games on the specifed date. Including home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), weather, and gameday information like referee assignments.
Returns scores for games in the specified season. Includes gameday information live and post-game. Live data includes down and distance, and game clock. Gameday info includes referee, weather, TV channel, and more.
Full scores and gameday info delivered live and post-game. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
Returns scores for games on the specified date. Including gameday details, weather, referee, infotainment odds, quarter-by-quarter scores, and final score.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
week
integer
true
Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
Example: 1
Games - by Date [Live & Final]
Retrieving up-to-the-second high-level game information, such as scores and game status.
Returns scores for games on the specifed date. Including home and away teams, dates, start time, stadium, broadcast channel, game status, inning, pre-game lines (moneyline, spread, total runs), weather, and gameday information like referee assignments.
Score tickers, live dashboards, and checking game status updates.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the games. Examples: 2021-SEP-12, 2021-NOV-28.
Games - by Season [Live & Final]
Returns scores for games in the specified season. Includes gameday information live and post-game. Live data includes down and distance, and game clock. Gameday info includes referee, weather, TV channel, and more.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type). Examples: 2018, 2018PRE, 2018POST, 2018STAR, 2019, etc.
Games - by Week [Live & Final]
Full scores and gameday info delivered live and post-game. Live data includes down and distance, as well as game clock. Gameday info includes referee, weather, TV channel etc.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns all statistics for the specified game, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
Specify a season, a player, and number of games (either an integer or all) to see all of their box score logs. Refreshed after their most recent game is complete.
Specify a season, a team, and number of games (either an integer or all) to see all of their box score logs. Refreshed after their most recent game is complete.
Returns all offensive red zone stats (inside the opponent’s 20-yard line) for all players in a specified season or week, which are delivered post-game.
Returns full live stats for a specified team’s game in the specified week and season, including detailed team and player stats updated during the game.
Returns all statistics for the specified game, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final.
Returns box scores for all games in a specified season and week, including only player stats updated in the last X minutes. Supports filtering by player type (e.g., fantasy, IDP, or all). Data is live and not final.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns all statistics for the specified game, including team and player stats, after the game has been completed. Due to stat corrections, box scores are subject to change after the game is Final.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
week
integer
true
Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
Example: 1
Player Game Logs - by Season
Specify a season, a player, and number of games (either an integer or all) to see all of their box score logs. Refreshed after their most recent game is complete.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Season to get games from. Example 2019POST, 2020
playerid
integer
true
Unique SportsDataIO Player ID. Example:17920.
numberofgames
string
true
How many games to return. Example all, 10, 25
Player Game Logs - by Season
Specify a season, a team, and number of games (either an integer or all) to see all of their box score logs. Refreshed after their most recent game is complete.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Season to get games from. Example 2019POST, 2020
teamid
integer
true
Unique ID of team. Example 8
numberofgames
string
true
How many games to return. Example all, 10, 25
Player Game Red Zone Stats
Returns all offensive red zone stats (inside the opponent’s 20-yard line) for all players in a specified season or week, which are delivered post-game.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
Box Score - by Team [Live & Final]
Returns full live stats for a specified team’s game in the specified week and season, including detailed team and player stats updated during the game.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
week
integer
true
Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
Example: 1
hometeam
string
true
Abbreviation of a team playing in this game. Example: WAS.
Box Score [Live & Final]
Retrieving real-time player and team statistics for a single game
Returns all statistics for the specified game, including team and player stats, both during and after the games. Due to stat corrections, box scores are subject to change after the game is Final.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of the game. Possible values include: 16247, 16245, etc.
Box Scores Delta - by Week
Returns box scores for all games in a specified season and week, including only player stats updated in the last X minutes. Supports filtering by player type (e.g., fantasy, IDP, or all). Data is live and not final.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns all individual plays for a specified team, including play type, outcome, and detailed player and team stats at the play level. Data is final and delivered after the game ends.
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered after the game.
Returns all individual plays for a specified team, including play type, outcome, and detailed player and team stats at the play level. Data is delivered live and/or available after the game ends.
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
Returns all play-by-play for the specified season and week, but only returns plays that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
Returns all individual plays for a specified team, including play type, outcome, and detailed player and team stats at the play level. Data is final and delivered after the game ends.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered after the game.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of a NFL game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905
Play By Play - by Team [Live & Final]
Returns all individual plays for a specified team, including play type, outcome, and detailed player and team stats at the play level. Data is delivered live and/or available after the game ends.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
week
integer
true
Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
Example: 1
hometeam
string
true
Abbreviation of the home team. Example: WAS.
Play By Play [Live & Final]
Returns all plays for the specified game with each play's type and outcomes, complete with player and team stats. All of which is delivered during and after the game.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of a NFL game. GameIDs can be found in the Games API. Valid entries are 14620 or 16905
Play By Play Delta
Returns all play-by-play for the specified season and week, but only returns plays that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns depth chart information for all rostered players within a team's organization who are expected to play during the current season. This endpoint is agnostic of roster status and includes players on IR, PUP, etc. as long as they are expected to return during the current season. Note that practice squad players, as well as players who will miss the remainder of the season, are not included.
Returns depth chart information for all players currently on a team's active roster. Players on IR, PUP, etc. are not included, nor are practice squad players.
Returns rookie players with their biographical information, position, college, and current team (if assigned). Use the year parameter to retrieve profiles from a specific rookie draft class.
Returns depth chart information for all rostered players within a team's organization who are expected to play during the current season. This endpoint is agnostic of roster status and includes players on IR, PUP, etc. as long as they are expected to return during the current season. Note that practice squad players, as well as players who will miss the remainder of the season, are not included.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Depth Charts - by Active
Returns depth chart information for all players currently on a team's active roster. Players on IR, PUP, etc. are not included, nor are practice squad players.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
Player Details - by Rookie Draft Year
Returns rookie players with their biographical information, position, college, and current team (if assigned). Use the year parameter to retrieve profiles from a specific rookie draft class.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns in-play game odds (spread, moneyline, total) for games in the specified week, meaning odds for games that are in-progress. Returns only the most recent data and does not include line movement.
Returns in-play game odds (spread, moneyline, total) for games in the specified week. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This also includes resulting for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
Returns the non-full-game odds (spread, moneyline, total) for games in the specified week. Non-full-game means 1st half or 1st quarter, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
Returns the full-game and non-full-game odds (spread, moneyline, total) for games in the specified season and week. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
Returns the full-game odds (moneyline, spread, total) for games in the specified week. Returns only the most recent data and does not include line movement.
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns the game odds for the specified game. In this endpoint both full-game and partial-game odds are included. Returns the full line movement for the given game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns the game odds ( for games in a given week and season. In this endpoint both full-game and partial-game odds are included.
This also includes Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
A Sportsbook Group must be specified as a URL parameter.
Returns the full-game core odds for a specified game. This means moneyline, spread, and total. Only returns the most recently seen odds, not-including line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
Returns in-play game odds (spread, moneyline, total) for games in the specified week, meaning odds for games that are in-progress. Returns only the most recent data and does not include line movement.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season, with optional season type. Examples: 2018, 2018POST, etc.
week
integer
true
The week of the scores (games). Examples: 1, 2, etc.
In-Game Odds by Week [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for games in the specified week. A Sportsbook Group must also be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season, with optional season type. Examples: 2018, 2018POST, etc.
week
integer
true
The week of the scores (games). Examples: 1, 2, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
In-Game Odds Line Movement
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of an NFL score (game). ScoreIDs can be found in the Scores API. Valid entries are 16654 or 16667
In-Game Odds Line Movement [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of an NFL score (game). ScoreIDs can be found in the Scores API. Valid entries are 16654 or 16667
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
In-Game Odds Line Movement with Resulting [Sportsbook Group]
Returns in-play game odds (spread, moneyline, total) for the specified game. Returns the full line movement. This also includes resulting for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line. A Sportsbook Group must be specified as a URL parameter.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of an NFL score (game). ScoreIDs can be found in the Scores API. Valid entries are 16654 or 16667
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Period Game Odds - by Week
Returns the non-full-game odds (spread, moneyline, total) for games in the specified week. Non-full-game means 1st half or 1st quarter, for example, rather than full game. Only returns the most recent odds, not inclusive of line movement.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season, with optional season type. Examples: 2018, 2018POST, etc.
week
integer
true
The week of the scores (games). Examples: 1, 2, etc.
Pre-Game and Period Game Odds - by Week [Sportsbook Group]
Returns the full-game and non-full-game odds (spread, moneyline, total) for games in the specified season and week. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season, with optional season type. Examples: 2018, 2018POST, etc.
week
integer
true
The week of the scores (games). Examples: 1, 2, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Pre-Game Odds - by Week
Retrieving the most recent pre-game odds data
Returns the full-game odds (moneyline, spread, total) for games in the specified week. Returns only the most recent data and does not include line movement.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season, with optional season type. Examples: 2018, 2018POST, etc.
week
integer
true
The week of the scores (games). Examples: 1, 2, etc.
Period Game Odds Line Movement
Returns the non-full-game odds (spread, moneyline, total), with line movement, for the specified game. Non-full-game means 1st half or 1st quarter, for example, rather than full game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of an NFL score (game). ScoreIDs can be found in the Scores API. Valid entries are 16654 or 16667
Pre-Game and Period Game Odds Line Movement [Sportsbook Group]
Returns the game odds for the specified game. In this endpoint both full-game and partial-game odds are included. Returns the full line movement for the given game. A Sportsbook Group must also be specified as a URL parameter. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of an NFL score (game). ScoreIDs can be found in the Scores API. Valid entries are 16654 or 16667
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Pre-Game and Period Game Odds Line Movement with Resulting [Sportsbook Group]
Returns the game odds ( for games in a given week and season. In this endpoint both full-game and partial-game odds are included.
This also includes Resulting: for markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Returns the full line movement for the given game. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
A Sportsbook Group must be specified as a URL parameter.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of an NFL score (game). ScoreIDs can be found in the Scores API. Valid entries are 16654 or 16667
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Pre-Game Odds Line Movement
Returns the full-game core odds for a specified game. This means moneyline, spread, and total. Only returns the most recently seen odds, not-including line movement. This endpoint has a longer cache as it is meant for historical data/line movement rather than the most up to the second line.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns BettingEvents for the specified 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).
Returns BettingEvents for the specified 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).
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
Returns markets and available outcomes for the specified event and market type. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Returns markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
Returns player props for the specified game. A Sportsbook Group must also be specified as a URL parameter. This works the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only.
Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
Returns resulting for the specified market that is supported for results. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. A Sportsbook Group must also be specified as a URL parameter.
Returns BettingEvents for the specified 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).
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
date
string
true
The date of the game(s). Examples: 2020-09-10, 2020-09-13.
Betting Events - by Season
Returns BettingEvents for the specified 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).
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Receiving a high-level view of all betting markets offered for a game
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The ScoreID of the desired game/score for which to pull all betting markets (includes outcomes/bets).
Betting Markets - by Game [Sportsbook Group]
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID. A Sportsbook Group must also be specified as a URL parameter.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Desired response format. Valid entries are XML or JSON.
gameid
integer
true
The GameID of the desired game/score for which to pull all betting markets (includes outcomes/bets).
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Markets - by Market Type
Returns markets and available outcomes for the specified event and market type. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for Game Lines, 2 for Player Props, 3 for Team Props, 6 for Game Props
Betting Markets - by Market Type [Sportsbook Group]
Retrieving lowest latency betting markets for a given game
Returns markets and available outcomes for the specified event and market type. A Sportsbook Group must also be specified as a URL parameter. This is a lighter call than by BettingEventID as it only includes markets tagged with the specific MarketType, a full list of which is available for each sport in its Betting Metadata endpoint.
Retrieving all betting markets for a given market type within a game
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Desired response format. Valid entries are XML or JSON.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).
marketTypeID
string
true
The Market Type ID of the desired MarketTypes to pull. Some common types include: 1 for Game Lines, 2 for Player Props, 3 for Team Props, 6 for Game Props
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Player Props - by Game
Returns player props available in the specified game. Works in the same way as Betting Markets by Market Type, but is prefiltered to the Player Props type only.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The unique ScoreID of the game in question.
Betting Player Props - by Game [Sportsbook Group]
Retrieving the lowest latency player props within a game
Returns player props for the specified game. A Sportsbook Group must also be specified as a URL parameter. This works the same way as Betting Markets by Market Type but is prefiltered to the Player Props type only.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
This parameter indicates which BettingOutcome records to return in the payload. By default, this endpoint only returns available outcomes, excluding the unlisted bets.
Important Note: the default parameter of available is much faster and provides the best performance. Passing unlisted will return unlisted odds, but these are cached for much longer and may be several minutes old. For best performance, the default parameter is highly recommended.
Possible values include:
available - excludes any betting outcomes that have been removed/unlisted by the respective sportsbook. This is more lightweight and delivers odds much faster than using unlisted.
unlisted - includes the most recently available betting outcome per sportsbook, for each listed market, even those outcomes are expired/unlisted or otherwise unavailable from the respective sportsbook. This is a far heavier payload, and it's cached for much longer than available.
Desired response format. Valid entries are XML or JSON.
scoreid
integer
true
The unique ScoreID of the game in question.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Market
Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
Betting Market [Sportsbook Group]
Returns full line movement for a specified BettingMarket. A Sportsbook Group must also be specified as a URL parameter. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100
Betting Results - by Market
Returns resulting for the specified market that is supported for result. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The MarketId of the desired market for which to pull all outcomes/bets.
Betting Results - by Market [Sportsbook Group]
Returns resulting for the specified market that is supported for results. For markets with a ResultType, each line will be graded and it will be determined whether the bet would have won or lost. A Sportsbook Group must also be specified as a URL parameter.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season (with optional season type). Examples: 2020REG, 2020PRE, 2020POST, 2021, etc.
Betting Futures - by Season [Sportsbook Group]
Returns available Futures markets for the specified season. A Sportsbook Group must also be specified as a URL parameter. This endpoint does not include line movement.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
Returns trends data for a specified pairing of teams (team vs opponent) - Last X games. Will return data even if the teams are not set to play this season. This is intended for use with a specific game, though it will work for other comparisons if applicable.
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified market. This endpoint will return the movement from this market as well as the most recent.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
marketId
string
true
The BettingMarketID of the market you would like to get splits for. Note that markets we do not have split information on will return an empty response.
Betting Splits - by Game
Returns a list of Money and Bet Percentage splits for each outcome type available in the specified game. This endpoint will return the movement from this market as well as the most recent.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
scoreId
integer
true
The ScoreID of the desired game to get Betting Market Splits for
Betting Trends - by Matchup
Returns trends data for a specified pairing of teams (team vs opponent) - Last X games. Will return data even if the teams are not set to play this season. This is intended for use with a specific game, though it will work for other comparisons if applicable.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
SportsDataIO's proprietary projections, including DFS salary information, for all fantasy defense teams. Called by season and week. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
SportsDataIO's proprietary projections, including average draft position, for all fantasy defense teams for the season. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
week
integer
true
Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
Example: 1
Projected Fantasy Defense Game Stats With DFS Salaries
SportsDataIO's proprietary projections, including DFS salary information, for all fantasy defense teams. Called by season and week. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
week
integer
true
Week of the season. Valid values are as follows: Preseason 0 to 4, Regular Season 1 to 17, Postseason 1 to 4.
Example: 1
Projected Fantasy Defense Season Stats With ADP
SportsDataIO's proprietary projections, including average draft position, for all fantasy defense teams for the season. Does not contain Individual Defensive Players (IDP), which have their own endpoint.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
season
string
true
Year of the season and the season type. If no season type is provided, then the default is regular season.
Examples: 2015REG, 2015PRE, 2015POST.
team
string
true
Abbreviation of the team. Example: WAS.
DFS Slate Ownership Projections - by Slate
Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
The SportsDataIO API Free Trial only provides access to the UEFA Champions League (Competition ID: 3)
If you need access to additional data, check out SportsDataIO Replay or reach out to our sales team and we can discuss other testing options.
Desired response format. Valid entries are XML or JSON.
FAQ
Frequently Asked Questions
Use the live games endpoints for scores, clock, quarter, and game state; use the relevant box-score and play-by-play endpoints when the experience needs player statistics or event detail. The NFL workflow guide explains which feeds change during games and how they fit together.
A game reaching Final does not necessarily mean all statistical verification is complete. Where available, use the `IsClosed` flag as the stronger completion signal, and continue to accommodate subsequent official corrections. The game-status process guide explains this distinction.
Use the NFL data dictionary for field types and meanings, the NFL coverage page for feed-level availability, and the workflow guide for operational timing. Endpoint call intervals are guidance for polling, not a guarantee that every field changes on each call.