Soccer API Documentation

This is the documentation for our Soccer 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:

Coverage
Workflow Guide
Data Dictionary
Help Center

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}

  • JSON
  • XML

Competition Feeds

Standings, Rankings & Brackets

Available Endpoints
Subfeed
GET Areas (Countries)
Standings, Rankings & Brackets
Returns a list of countries and continents with their associated competitions.
Area Competition Game PlayerSeason PlayoffAggregateScore Round Season Standing TeamSeason
GET Competitions (Leagues)
Standings, Rankings & Brackets
Returns a list of all competitions (leagues, cups, etc.) along with their associated countries or regions.
Competition Game PlayerSeason PlayoffAggregateScore Round Season Standing TeamSeason
GET Standings
Standings, Rankings & Brackets
Returns regular season standings for a specified league or tournament and season
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason

Areas (Countries)

Returns a list of countries and continents with their associated competitions.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Area[]
Included Data Tables:
Area Competition Game PlayerSeason PlayoffAggregateScore Round Season Standing TeamSeason
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/Areas
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Competitions (Leagues)

Returns a list of all competitions (leagues, cups, etc.) along with their associated countries or regions.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Competition[]
Included Data Tables:
Competition Game PlayerSeason PlayoffAggregateScore Round Season Standing TeamSeason
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/Competitions
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Standings

Returns regular season standings for a specified league or tournament and season
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Round[]
Included Data Tables:
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/Standings/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Teams, Players & Rosters

Available Endpoints
Subfeed
GET Memberships - by Active
Teams, Players & Rosters
Returns players currently active on teams in a specified competition.
Membership
GET Memberships - by Canceled
Teams, Players & Rosters
Returns player-team memberships that have been revoked by the system.
CanceledMembership
GET Memberships - by Recently Changed
Teams, Players & Rosters
Returns a list of recently changed player-team memberships (e.g., transfers, releases) for a specified competition, filtered by number of days ago.
Membership
GET Memberships Historical - by Team
Teams, Players & Rosters
Returns historical team memberships, listing players who were previously on the roster but have since left.
Membership
GET Player Profiles - by Team
Teams, Players & Rosters
Returns roster information for a specified team, including player profiles with basic biographical details, position, and more. Use the TeamId parameter to retrieve all current players on that team.
PlayerBasic
GET Team Profiles - by Competition
Teams, Players & Rosters
Returns full team information, including name, city, conference, division, colors, fantasy IDs, and complete stadium data. Includes all teams ever associated with a competition. Use Team Profiles - by Season for current teams only.
Team
GET Team Profiles - by Season
Teams, Players & Rosters
Returns full team information, including name, city, conference, division, colors, fantasy IDs, and complete stadium data. Includes teams currently active in a competition's season. Use Team Profiles - by Competition for historical teams.
SeasonTeam Team

Memberships - by Active

Returns players currently active on teams in a specified competition.
Endpoint Notes
Call Interval:
1 Day
Return Type:
Membership[]
Included Data Tables:
Membership
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/ActiveMemberships/{competition}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.

Memberships - by Canceled

Returns player-team memberships that have been revoked by the system.
Endpoint Notes
Call Interval:
1 Day
Return Type:
CanceledMembership
Included Data Tables:
CanceledMembership
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/CanceledMemberships
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Memberships - by Recently Changed

Returns a list of recently changed player-team memberships (e.g., transfers, releases) for a specified competition, filtered by number of days ago.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Membership[]
Included Data Tables:
Membership
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/RecentlyChangedMemberships/{competition}/{days}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
days
string
true
The number of days since memberships were updated. For example, if you pass 3, you'll receive all memberships that have been updated in the past 3 days. Valid entries are: 1, 2 ... 30

Memberships Historical - by Team

Returns historical team memberships, listing players who were previously on the roster but have since left.
Endpoint Notes
Call Interval:
1 Day
Return Type:
Membership[]
Included Data Tables:
Membership
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/HistoricalMembershipsByTeam/{competition}/{teamid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
teamid
integer
true
Unique FantasyData Team ID. Example:516.

Player Profiles - by Team

Returns roster information for a specified team, including player profiles with basic biographical details, position, and more. Use the TeamId parameter to retrieve all current players on that team.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerBasic[]
Included Data Tables:
PlayerBasic
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/PlayersByTeamBasic/{competition}/{teamid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
teamid
integer
true
Unique FantasyData Team ID. Example:516.

Team Profiles - by Competition

Returns full team information, including name, city, conference, division, colors, fantasy IDs, and complete stadium data. Includes all teams ever associated with a competition. Use Team Profiles - by Season for current teams only.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Team[]
Included Data Tables:
Team
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/Teams/{competition}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.

Team Profiles - by Season

Returns full team information, including name, city, conference, division, colors, fantasy IDs, and complete stadium data. Includes teams currently active in a competition's season. Use Team Profiles - by Competition for historical teams.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
SeasonTeam[]
Included Data Tables:
SeasonTeam Team
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/SeasonTeams/{competition}/{seasonid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
seasonid
integer
true
Unique FantasyData Season ID. SeasonIDs can be found in the Competition Hierarchy (League Hierarchy). Examples: 1, 2, 3, etc

Venues & Officials

Available Endpoints
Subfeed
GET Venues
Venues & Officials
Returns stadiums from around the world, including name, location, latitude, longitude, capacity, and surface type.
Venue

Venues

Returns stadiums from around the world, including name, location, latitude, longitude, capacity, and surface type.
Endpoint Notes
Call Interval:
4 Hours
Return Type:
Venue[]
Included Data Tables:
Venue
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/Venues
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Utility Endpoints

Available Endpoints
Subfeed
GET Betting Metadata
Utility Endpoints
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.
BettingEntityMetadata BettingEntityMetadataCollection
GET Sportsbooks - by Active
Utility Endpoints
Returns a list of all available sportsbooks with their associated unique IDs.
Sportsbook

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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
BettingEntityMetadataCollection
Included Data Tables:
BettingEntityMetadata BettingEntityMetadataCollection
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMetadata
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Sportsbooks - by Active

Returns a list of all available sportsbooks with their associated unique IDs.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Sportsbook[]
Included Data Tables:
Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/ActiveSportsbooks
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.

Event Feeds

Schedules & Game Day Info

Available Endpoints
Subfeed
GET Schedules
Schedules & Game Day Info
Returns game details including home and away teams, date and time, season type, week, and gameday info. Also includes stadium information (capacity) and top-line betting info (spread, moneyline, total).
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
GET Schedules (Basic)
Schedules & Game Day Info
Returns a full schedule of games for the specified competition and season. Includes home and away teams, date, start time, stadium, game status, 1st Half and 2nd Half scores, and pre-game lines (moneyline, spread, total).
PlayoffAggregateScore ScheduleBasic

Schedules

Returns game details including home and away teams, date and time, season type, week, and gameday info. Also includes stadium information (capacity) and top-line betting info (spread, moneyline, total).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Round[]
Included Data Tables:
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
Ideal For:
Populating calendar views, retrieving GameID’s to link to other feeds, and getting 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.
GET https://api.sportsdata.io/v4/soccer/scores/json/Schedule/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Schedules (Basic)

Returns a full schedule of games for the specified competition and season. Includes home and away teams, date, start time, stadium, game status, 1st Half and 2nd Half scores, and pre-game lines (moneyline, spread, total).
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
ScheduleBasic[]
Included Data Tables:
PlayoffAggregateScore ScheduleBasic
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/SchedulesBasic/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Scores & Game State

Available Endpoints
Subfeed
GET Games - by Competition [Live & Final]
Final Only (No Game State)
Returns full scores and gameday info live and post-game, including half and full score details, delivered by competition.
CompetitionDetail Game Player PlayerSeason PlayoffAggregateScore Round Season Standing TeamDetail TeamSeason
GET Games - by Date [Final]
Final Only (No Game State)
Returns final scores for all games on the specified date. Includes stadium, attendance, game status, pre-game lines (moneyline, spread, total), and half and full-time scores.
Game PlayoffAggregateScore
GET Games (Basic) - by Date [Final]
Final Only (No Game State)
Returns top-line full-time game information for a specified competition and date, delivered post-game.
PlayoffAggregateScore ScoreBasic
GET Games - by Date [Live & Final]
Live & Final (With Game State)
Returns live and final scores for all games on the specified date. Includes stadium, attendance, game status, pre-game lines (moneyline, spread, total), and half and full-time scores.
Game PlayoffAggregateScore
GET Games (Basic) - by Date [Live & Final]
Live & Final (With Game State)
Returns top-line full-time game information for a specified competition and date.
PlayoffAggregateScore ScoreBasic

Games - by Competition [Live & Final]

Returns full scores and gameday info live and post-game, including half and full score details, delivered by competition.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
CompetitionDetail
Included Data Tables:
CompetitionDetail Game Player PlayerSeason PlayoffAggregateScore Round Season Standing TeamDetail TeamSeason
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/CompetitionDetails/{competition}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.

Games - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games - by Date [Live & Final].
Returns final scores for all games on the specified date. Includes stadium, attendance, game status, pre-game lines (moneyline, spread, total), and half and full-time scores.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Game PlayoffAggregateScore
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/GamesByDateFinal/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Games (Basic) - by Date [Final]

This is the Final version of this endpoint. For live data, please use Games (Basic) - by Date [Live & Final].
Returns top-line full-time game information for a specified competition and date, delivered post-game.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
ScoreBasic[]
Included Data Tables:
PlayoffAggregateScore ScoreBasic
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/ScoresBasicFinal/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Games - by Date [Live & Final]

Retrieving up-to-the-second high-level game information, such as scores and game status.
Returns live and final scores for all games on the specified date. Includes stadium, attendance, game status, pre-game lines (moneyline, spread, total), and half and full-time scores.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
Game[]
Included Data Tables:
Game PlayoffAggregateScore
Ideal For:
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/GamesByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Games (Basic) - by Date [Live & Final]

Returns top-line full-time game information for a specified competition and date.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
ScoreBasic[]
Included Data Tables:
PlayoffAggregateScore ScoreBasic
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/ScoresBasic/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Team & Player Stats

Available Endpoints
Subfeed
GET Box Score [Final]
Final Only
Returns all statistics for a specified game, including team and player stats, after the game has been completed. Box scores are subject to change after they are final. They are finalized once a game is closed.
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
GET Box Scores - by Date [Final]
Final Only
Returns all statistics for all games on the specified date, 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.
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
GET Player Game Stats - by Date [Final]
Final Only
Returns box score stats for all players that participated in a game on the specified date. Data is added for players once their respective game concludes.
PlayerGame
GET Player Season Stats
Final Only
Returns season-long stats for all players on a team for the specified season.
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
GET Team Game Stats - by Date [Final]
Final Only
Returns box score stats for each team on the specified date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
TeamGame
GET Team Season Stats
Final Only
Returns season-long stats (i.e. the season total, not each individual game record) for all teams in the specified season.
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
GET Box Score [Live & Final]
Live & Final
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.
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
GET Box Scores - by Date [Live & Final]
Live & Final
Returns all statistics for all games on the specified date, 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.
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
GET Box Scores Delta - by Date
Live & Final
Returns all stats for the specified date, only returning player stats that have changed in the last X minutes, as given in the API call. This is a live endpoint, not final, meaning that it will return data for games in progress.
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
GET Player Game Stats - by Date [Live & Final]
Live & Final
Returns box score stats for all players that participated in a game on the specified date. All of which is updated during and after games.
PlayerGame
GET Team Game Stats - by Date [Live & Final]
Live & Final
Returns team stats for the specified team's game on the specified date. All of which is delivered during and after games.
TeamGame

Box Score [Final]

This is the Final version of this endpoint. For live data, please use Box Score [Live & Final].
Returns all statistics for a specified game, including team and player stats, after the game has been completed. Box scores are subject to change after they are final. They are finalized once a game is closed.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/BoxScoreFinal/{competition}/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 702, 1274, etc.

Box Scores - by Date [Final]

This is the Final version of this endpoint. For live data, please use Box Scores - by Date [Live & Final].
Returns all statistics for all games on the specified date, 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.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/BoxScoresFinal/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Player Game Stats - by Date [Final]

This is the Final version of this endpoint. For live data, please use Player Game Stats - by Date [Live & Final].
Returns box score stats for all players that participated in a game on the specified date. Data is added for players once their respective game concludes.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGame[]
Included Data Tables:
PlayerGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/PlayerGameStatsByDateFinal/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Player Season Stats

Returns season-long stats for all players on a team for the specified season.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
Round[]
Included Data Tables:
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/PlayerSeasonStats/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Team Game Stats - by Date [Final]

This is the Final version of this endpoint. For live data, please use Team Game Stats - by Date [Live & Final].
Returns box score stats for each team on the specified date. Team stats are an aggregation of all player stats. Data is updated as each game is completed.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/TeamGameStatsByDateFinal/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Team Season Stats

Returns season-long stats (i.e. the season total, not each individual game record) for all teams in the specified season.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
Round[]
Included Data Tables:
Game PlayerSeason PlayoffAggregateScore Round Standing TeamSeason
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/TeamSeasonStats/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Box Score [Live & Final]

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.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/BoxScore/{competition}/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 702, 1274, etc.

Box Scores - by Date [Live & Final]

Returns all statistics for all games on the specified date, 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.
Endpoint Notes
Call Interval:
1 Minute
Return Type:
BoxScore[]
Included Data Tables:
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/BoxScoresByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Box Scores Delta - by Date

Returns all stats for the specified date, only returning player stats that have changed in the last X minutes, as given in the API call. This is a live endpoint, not final, meaning that it will return data for games in progress.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
BoxScore[]
Included Data Tables:
Booking BoxScore Coach Game Goal Lineup PenaltyShootout PlayerGame PlayoffAggregateScore Referee TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/BoxScoresDeltaByDate/{competition}/{date}/{minutes}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.
minutes
string
true
Only returns player statistics that have changed in the last X minutes. You specify how many minutes in time to go back. Valid entries are: 1, 2 ... all.

Player Game Stats - by Date [Live & Final]

Returns box score stats for all players that participated in a game on the specified date. All of which is updated during and after games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGame[]
Included Data Tables:
PlayerGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/PlayerGameStatsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Team Game Stats - by Date [Live & Final]

Returns team stats for the specified team's game on the specified date. All of which is delivered during and after games.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
TeamGame[]
Included Data Tables:
TeamGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/TeamGameStatsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Player Feeds

Depth Charts, Lineups & Injuries

Available Endpoints
Subfeed
GET Lineups - by Date
Depth Charts, Lineups & Injuries
Returns confirmed starting lineups and substitute benches for a specified competition and date.
PlayerGameBasic
GET Player Details - by Injured
Depth Charts, Lineups & Injuries
Returns all injured players along with injury information (status, start date, body part, and note).
Player
GET Player Details - by Team
Depth Charts, Lineups & Injuries
Returns all players on specified team, with full bio information and injury information.
Player

Lineups - by Date

Returns confirmed starting lineups and substitute benches for a specified competition and date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGameBasic[]
Included Data Tables:
PlayerGameBasic
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/LineupsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Player Details - by Injured

Returns all injured players along with injury information (status, start date, body part, and note).
Endpoint Notes
Call Interval:
3 Minutes
Return Type:
Player[]
Included Data Tables:
Player
 
 
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.
GET https://api.sportsdata.io/v4/soccer/projections/json/InjuredPlayers/{competition}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.

Player Details - by Team

Returns all players on specified team, with full bio information and injury information.
Endpoint Notes
Call Interval:
1 Hour
Return Type:
Player[]
Included Data Tables:
Player
 
 
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.
GET https://api.sportsdata.io/v4/soccer/scores/json/PlayersByTeam/{competition}/{teamid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
teamid
integer
true
Unique FantasyData Team ID. Example:516.

Betting Feeds

Game Lines

Available Endpoints
Subfeed
GET In-Game Odds - by Date
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games on the specified date, meaning odds for games that are in-progress. Returns only the most recent data and does not include line movement.
GameInfo GameOdd
GET In-Game Odds - by Date [Sportsbook Group]
In-Play Lines
Returns in-play game odds (spread, moneyline, total) for games on the specified date. 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.
GameInfo GameOdd
GET In-Game Odds Line Movement
In-Play Lines Plus
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.
GameInfo GameOdd
GET In-Game Odds Line Movement [Sportsbook Group]
In-Play Lines Plus
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.
GameInfo GameOdd
GET In-Game Odds Line Movement with Resulting [Sportsbook Group]
In-Play Lines Plus
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.
GameInfoResult GameOddOutcome GameOddResult
GET Period Game Odds - by Date
Pre-Game Lines
Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. 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.
GameInfo GameOdd
GET Pre-Game and Period Game Odds - by Date [Sportsbook Group]
Pre-Game Lines
Returns the full-game and non-full-game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
GameInfo GameOdd
GET Pre-Game Odds - by Date
Pre-Game Lines
Returns the full-game odds (moneyline, spread, total) for games on the specified date. Returns only the most recent data and does not include line movement.
GameInfo GameOdd
GET Period Game Odds Line Movement
Pre-Game Lines Plus
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.
GameInfo GameOdd
GET Pre-Game and Period Game Odds Line Movement [Sportsbook Group]
Pre-Game Lines Plus
Returns the game odds for games on the specified date. 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.
GameInfo GameOdd
GET Pre-Game and Period Game Odds Line Movement with Resulting [Sportsbook Group]
Pre-Game Lines Plus
Returns the game odds for games on the specified date. 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. 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.
GameInfoResult GameOddOutcome GameOddResult
GET Pre-Game Odds Line Movement
Pre-Game Lines Plus
Returns the full-game core odds (moneyline, spread, total) for the specified game. Returns only the most recent data and does not include 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.
GameInfo GameOdd

In-Game Odds - by Date

Returns in-play game odds (spread, moneyline, total) for games on the specified date, meaning odds for games that are in-progress. Returns only the most recent data and does not include line movement.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/LiveGameOddsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.

In-Game Odds - by Date [Sportsbook Group]

Returns in-play game odds (spread, moneyline, total) for games on the specified date. 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.
Endpoint Notes
Call Interval:
5 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/InGameOddsByDate/{competition}/{date}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2018-06-20, 2018-06-23.
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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/LiveGameOddsLineMovement/{competition}/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 14060, 14061, etc.

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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/InGameOddsLineMovement/{competition}/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 14060, 14061, etc.
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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
Included Data Tables:
GameInfoResult GameOddOutcome GameOddResult
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/InGameOddsLineMovementWithResulting/{competition}/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 14060, 14061, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Period Game Odds - by Date

Returns the non-full-game odds (spread, moneyline, total) for games on the specified date. 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.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/AlternateMarketGameOddsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Pre-Game and Period Game Odds - by Date [Sportsbook Group]

Returns the full-game and non-full-game odds (spread, moneyline, total) for games on the specified date. A Sportsbook Group must be specified as a URL parameter. Only returns the most recent odds, not inclusive of line movement.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/PreGameOddsByDate/{competition}/{date}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Pre-Game Odds - by Date

Retrieving the most recent pre-game odds data
Returns the full-game odds (moneyline, spread, total) for games on the specified date. Returns only the most recent data and does not include line movement.
Endpoint Notes
Call Interval:
30 Seconds
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
Ideal For:
Receiving the most recent pre-game odds across a variety of sportsbooks
Not Ideal For:
Retrieving line movement (Use Pre-Game Odds Line Movement 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.
GET https://api.sportsdata.io/v4/soccer/odds/json/GameOddsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/AlternateMarketGameOddsLineMovement/{competition}/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 41323

Pre-Game and Period Game Odds Line Movement [Sportsbook Group]

Returns the game odds for games on the specified date. 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/PreGameOddsLineMovement/{competition}/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 14060, 14061, etc.
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 on the specified date. 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. 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfoResult[]
Included Data Tables:
GameInfoResult GameOddOutcome GameOddResult
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/PreGameOddsLineMovementWithResulting/{competition}/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 14060, 14061, etc.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Pre-Game Odds Line Movement

Returns the full-game core odds (moneyline, spread, total) for the specified game. Returns only the most recent data and does not include 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.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
GameInfo[]
Included Data Tables:
GameInfo GameOdd
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/GameOddsLineMovement/{competition}/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are 14060, 14061, etc.

Props

Available Endpoints
Subfeed
GET Betting Events - by Date
Props
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.)
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Events - by Season
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.)
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Event
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Event [Sportsbook Group]
Props
Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Game
Props
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Game [Sportsbook Group]
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.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Market Type
Props
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.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Markets - by Market Type [Sportsbook Group]
Props
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.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Player Props - by Game
Props
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.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Player Props - by Game [Sportsbook Group]
Props
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.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Futures - by Season
Props Plus
Returns available Futures markets for the specified season. This endpoint does not include line movement.
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Market
Props Plus
Returns full line movement for a given 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.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
GET Betting Market [Sportsbook Group]
Props Plus
Returns full line movement for a given 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. A Sportsbook Group must be specified as a URL parameter.
BettingMarket BettingOutcome ConsensusOutcome Sportsbook

Betting Events - by Date

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.)
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingEventsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2018-11-20, 2018-11-23.

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.)
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingEventsBySeason/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Betting Markets - by Event

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified BettingEventID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarkets/{competition}/{eventId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
eventId
string
true
The EventId of the desired event/game for which to pull all betting markets (includes outcomes/bets).

Betting Markets - by Event [Sportsbook Group]

Returns the markets and available outcomes for the specified BettingEventID. A Sportsbook Group must also be specified as a URL parameter.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarketsByEvent/{competition}/{eventId}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
eventId
string
true
The EventId of the desired event/game 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 Game

Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for the specified GameID.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarketsByGameID/{competition}/{gameid}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of the desired game 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.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarketsByGameID/{competition}/{gameid}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameid
integer
true
The GameID of the desired game 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.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarketsByMarketType/{competition}/{eventId}/{marketTypeID}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
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.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarketsByMarketType/{competition}/{eventId}/{marketTypeID}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
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.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingPlayerPropsByGameID/{competition}/{gameId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameId
integer
true
The unique GameID 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.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket[]
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
Ideal For:
Retrieving all player props for a given 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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingPlayerPropsByGameID/{competition}/{gameId}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
gameId
integer
true
The unique GameID of the game in question.
sportsbookgroup
string
true
Access Required
The name of the Sportsbook grouping.
Examples: G1100

Betting Futures - by Season

Returns available Futures markets for the specified season. This endpoint does not include line movement.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingEvent[]
Included Data Tables:
BettingEvent BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingFuturesBySeason/{competition}/{season}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
season
string
true
Year of the season
Examples: 2020, 2021, etc.

Betting Market

Returns full line movement for a given 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.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarket/{competition}/{marketId}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
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 given 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. A Sportsbook Group must be specified as a URL parameter.
Endpoint Notes
Call Interval:
10 Minutes
Return Type:
BettingMarket
Included Data Tables:
BettingMarket BettingOutcome ConsensusOutcome Sportsbook
 
 
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.
GET https://api.sportsdata.io/v4/soccer/odds/json/BettingMarket/{competition}/{marketId}/{sportsbookgroup}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
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

Fantasy Feeds

Projections

Available Endpoints
Subfeed
GET Projected Player Game Stats - by Date
Legacy Projections
Returns SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by date.
PlayerGameProjection

Projected Player Game Stats - by Date

Returns SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
PlayerGameProjection[]
Included Data Tables:
PlayerGameProjection
 
 
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.
GET https://api.sportsdata.io/v4/soccer/projections/json/PlayerGameProjectionStatsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

Salaries, Stats & Points

Available Endpoints
Subfeed
GET Fantasy Points - by Date
Points & Stats
Returns a simple list of fantasy points awarded to players who took part in a given competition's games on a given date.
FantasyGame
GET DFS Slates - by Date
Salaries & Slates
Returns DFS Slates which have not yet started, with their player and salary information.
DfsSlate DfsSlateGame DfsSlatePlayer Game PlayoffAggregateScore
GET Upcoming DFS Slates - by Competition
Salaries & Slates
Returns upcoming DFS Slates which have not yet started, with their player and salary information, by competition.
DfsSlate DfsSlateGame DfsSlatePlayer Game PlayoffAggregateScore

Fantasy Points - by Date

Returns a simple list of fantasy points awarded to players who took part in a given competition's games on a given date.
Endpoint Notes
Call Interval:
5 Minutes
Return Type:
FantasyGame[]
Included Data Tables:
FantasyGame
 
 
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.
GET https://api.sportsdata.io/v4/soccer/stats/json/FantasyGameStatsByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2017-02-27, 2017-09-01.

DFS Slates - by Date

Returns DFS Slates which have not yet started, with their player and salary information.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlate[]
Included Data Tables:
DfsSlate DfsSlateGame DfsSlatePlayer Game PlayoffAggregateScore
 
 
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.
GET https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByDate/{competition}/{date}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.
date
string
true
The date of the game(s).
Examples: 2020-02-18

Upcoming DFS Slates - by Competition

Returns upcoming DFS Slates which have not yet started, with their player and salary information, by competition.
Endpoint Notes
Call Interval:
15 Minutes
Return Type:
DfsSlate[]
Included Data Tables:
DfsSlate DfsSlateGame DfsSlatePlayer Game PlayoffAggregateScore
 
 
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.
GET https://api.sportsdata.io/v4/soccer/projections/json/UpcomingDfsSlatesByCompetition/{competition}
Query String Parameters
Name
Type
Required
Value
key
string
true
Subscription Required
URL Template Parameters
Parameter Name
Type
Required
Value
format
string
true
json change
Desired response format. Valid entries are XML or JSON.
competition
string
true
An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: EPL, 1, MLS, 8, etc.

News & Images

FAQ

Frequently Asked Questions

The Soccer API exposes competitions, seasons, rounds, games, and related identifiers that support a competition-driven data model. Use the soccer API documentation to discover supported competition keys and structure your ingestion around those relationships.

League availability does not guarantee identical detail. Confirm the competition, season, and the particular score, event, lineup, or statistical fields you need against the competition coverage directory and soccer endpoint reference.

Soccer has competition-specific phases, match statuses, and potentially different match and aggregate scoring contexts. Use the documented competition and game fields rather than assuming a single regular-season format. The soccer API documentation provides the relevant structures.

Contact Us