openapi: 3.1.0
info:
title: MLB MLB v3 Headshots Soccer v4 Stats API
version: '1.0'
description: MLB API - OpenAPI 3.1 Specification
servers:
- url: https://api.sportsdata.io
description: Production server
security:
- apiKeyHeader: []
- apiKeyQuery: []
tags:
- name: Soccer v4 Stats
paths:
/v4/soccer/stats/{format}/BoxScoresByDate/{competition}/{date}:
get:
description: Full statistical information for a specified game, down to the team and player stat level, delivered live during the games, called for all games on a given date within a competition.
operationId: soccer_v4_stats_box_scores___by_date__live___final
summary: Box Scores - by Date [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/BoxScoresDeltaByDate/{competition}/{date}/{minutes}:
get:
description: This method returns all box scores for a given date in a given competition, but only returns player stats that have changed in the last X minutes as specified in your API call. By definition this is a live endpoint, not final.
operationId: soccer_v4_stats_box_scores_delta___by_date
summary: Box Scores Delta - by Date
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
- name: minutes
in: path
description: '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:
<code>1</code>, <code>2</code> ... <code>all</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/BoxScore/{competition}/{gameid}:
get:
description: Full statistical information for a specified game, down to the team and player stat level, delivered live during the game, called per individual game.
operationId: soccer_v4_stats_box_score__live___final
summary: Box Score [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: gameid
in: path
description: The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are <code>702</code>, <code>1274</code>, etc.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/PlayerGameStatsByDate/{competition}/{date}:
get:
description: Returns the box score statistical record for all involved players across all teams' games on a given date in a given competition, both live and after each game has concluded.
operationId: soccer_v4_stats_player_game_stats___by_date__live___final
summary: Player Game Stats - by Date [Live & Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/PlayerSeasonStats/{competition}/{season}:
get:
description: Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.
operationId: soccer_v4_stats_player_season_stats
summary: Player Season Stats
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: season
in: path
description: 'Year of the season<br>Examples: <code>2020</code>, <code>2021</code>, etc.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Round'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/BoxScoreFinal/{competition}/{gameid}:
get:
description: Full statistical information for a specified game, down to the team and player stat level, delivered after the game is complete.
operationId: soccer_v4_stats_box_score__final
summary: Box Score [Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: gameid
in: path
description: The GameID of a Soccer game. GameIDs can be found in the Games API. Valid entries are <code>702</code>, <code>1274</code>, etc.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/BoxScoresFinal/{competition}/{date}:
get:
description: Full statistical information for a specified date for each game that took place, down to the team and player stat level, delivered after the game is complete.
operationId: soccer_v4_stats_box_scores___by_date__final
summary: Box Scores - by Date [Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/BoxScore'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/LineupsByDate/{competition}/{date}:
get:
description: Projected and confirmed starting XIs and substitute benches for a given competition on a given date.
operationId: soccer_v4_stats_lineups___by_date
summary: Lineups - by Date
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameBasic'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/PlayerGameStatsByDateFinal/{competition}/{date}:
get:
description: Returns the box score statistical record for all involved players across all teams' games for a given competition on a given date after each game has concluded.
operationId: soccer_v4_stats_player_game_stats___by_date__final
summary: Player Game Stats - by Date [Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/TeamGameStatsByDateFinal/{competition}/{date}:
get:
description: Returns the box score statistical record team-wide (aggregated from all players) for a games in a given competition on a given date, updated as each game has concluded.
operationId: soccer_v4_stats_team_game_stats___by_date__final
summary: Team Game Stats - by Date [Final]
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TeamGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
/v4/soccer/stats/{format}/FantasyGameStatsByDate/{competition}/{date}:
get:
description: A simple list of fantasy points awarded to players who took part in a given competition's games on a given date.
operationId: soccer_v4_stats_fantasy_points___by_date
summary: Fantasy Points - by Date
parameters:
- name: format
in: path
description: Desired response format. Valid entries are <code>JSON</code> or <code>XML</code>.
required: true
schema:
type: string
enum:
- JSON
- XML
default: JSON
- name: competition
in: path
description: 'An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: <code>EPL</code>, <code>1</code>, <code>MLS</code>, <code>8</code>, etc.'
required: true
schema:
type: string
- name: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-02-27</code>, <code>2017-09-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FantasyGame'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- Soccer v4 Stats
components:
schemas:
Standing:
properties:
StandingId:
type: integer
description: The unique ID of the standing
RoundId:
type: integer
description: The unique ID of the round that this team is associated with
TeamId:
type: integer
description: The unique ID of the team
Name:
type:
- string
- 'null'
description: The team's full name
ShortName:
type:
- string
- 'null'
description: The short name of the team
Scope:
type:
- string
- 'null'
description: 'The scope of the standing (possible values: Total, Away, Home)'
Order:
type:
- integer
- 'null'
description: The order of the teams in the standing (e.g 1; 2; 3; 4; etc.)
Games:
type:
- integer
- 'null'
description: Total number of games played by the team in the season
Wins:
type:
- integer
- 'null'
description: Number of wins by the team in the season
Losses:
type:
- integer
- 'null'
description: The number of losses for the team
Draws:
type:
- integer
- 'null'
description: Number of draws by the team in the season
GoalsScored:
type:
- integer
- 'null'
description: Total number of goals scored by the team in the season
GoalsAgainst:
type:
- integer
- 'null'
description: Total number of goals against by the team in the season
GoalsDifferential:
type:
- integer
- 'null'
description: 'The goal differential of the team in the season. Note: GoalDifferential = GoalsScored - GoalsAgainst'
Points:
type:
- integer
- 'null'
description: Total points accumulated by the team
Group:
type:
- string
- 'null'
description: The name of the group (when applicable)
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues.
PlayerGame:
properties:
StatId:
type: integer
description: The unique ID of the stat associated with this player
SeasonType:
type: integer
description: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Season:
type: integer
description: The soccer regular season for which these totals apply
RoundId:
type:
- integer
- 'null'
description: The unique ID of the round that this player is associated with
TeamId:
type:
- integer
- 'null'
description: The unique ID of the team
PlayerId:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID stays with the player their entire career.'
Name:
type:
- string
- 'null'
description: The player's full name
ShortName:
type:
- string
- 'null'
description: The short name of the player
Team:
type:
- string
- 'null'
description: The name of the team
PositionCategory:
type:
- string
- 'null'
description: The player's position category
Position:
type:
- string
- 'null'
description: 'The position of the player. Possible values include: A (Attacker); M (Midfielder); D (Defender); GK (Goalkeeper).'
Jersey:
type:
- integer
- 'null'
description: The player's jersey number
Started:
type:
- integer
- 'null'
description: The total number of games the player started
Captain:
type:
- boolean
- 'null'
description: Whether the player is a captain (true/false)
Suspension:
type:
- boolean
- 'null'
description: Whether the player is suspended or not (true/false)
SuspensionReason:
type:
- string
- 'null'
description: The reason given for the player's suspension
FanDuelSalary:
type:
- integer
- 'null'
description: The player's salary for FanDuel daily fantasy contests.
DraftKingsSalary:
type:
- integer
- 'null'
description: The player's salary for DraftKings daily fantasy contests.
YahooSalary:
type:
- integer
- 'null'
description: The player's salary for Yahoo daily fantasy contests
MondogoalSalary:
type:
- integer
- 'null'
description: The player's salary for Mondogoal's daily fantasy contests
FanDuelPosition:
type:
- string
- 'null'
description: The player's eligible position in FanDuel's daily fantasy sports platform.
DraftKingsPosition:
type:
- string
- 'null'
description: The player's eligible position in DraftKings' daily fantasy sports platform.
YahooPosition:
type:
- string
- 'null'
description: The player's eligible position in Yahoo's daily fantasy sports platform
MondogoalPosition:
type:
- string
- 'null'
description: The player's eligible position in Mondogoal's daily fantasy sports platform.
InjuryStatus:
type:
- string
- 'null'
description: 'Indicates the player''s injury status. Possible values: Questionable; Out.'
InjuryBodyPart:
type:
- string
- 'null'
description: The body part of the player that is injured (Knee; Groin; Calf; Hamstring; etc.)
InjuryNotes:
type:
- string
- 'null'
description: Not yet supported; will be null
InjuryStartDate:
type:
- string
- 'null'
description: The date that the injury started or was first discovered
GlobalTeamId:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues.
Corners:
type:
- number
- 'null'
description: Total number of corner kicks taken by the player in the game
GameId:
type:
- integer
- 'null'
description: The unique ID of this game
OpponentId:
type:
- integer
- 'null'
description: The unique ID of the team's opponent
Opponent:
type:
- string
- 'null'
description: The name of the opponent
Day:
type:
- string
- 'null'
description: The day of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game (UTC)
HomeOrAway:
type:
- string
- 'null'
description: Whether the team is home or away
IsGameOver:
type: boolean
description: Whether the game is over (true/false)
GlobalGameId:
type:
- integer
- 'null'
description: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues.
GlobalOpponentId:
type:
- integer
- 'null'
description: A globally unique ID for this opponent. This value is guaranteed to be unique across all sports/leagues.
Updated:
type:
- string
- 'null'
description: The timestamp of when the record was last updated (US Eastern Time)
UpdatedUtc:
type:
- string
- 'null'
description: The timestamp of when the record was last updated (UTC Time)
Games:
type:
- integer
- 'null'
description: The number of games played
FantasyPoints:
type:
- number
- 'null'
description: Total fantasy points
FantasyPointsFanDuel:
type:
- number
- 'null'
description: Total Fan Duel daily fantasy points scored
FantasyPointsDraftKings:
type:
- number
- 'null'
description: Total Draft Kings daily fantasy points scored
FantasyPointsYahoo:
type:
- number
- 'null'
description: Total Yahoo daily fantasy points scored
FantasyPointsMondogoal:
type:
- number
- 'null'
description: Total Mondogoal fantasy points scored
Minutes:
type:
- number
- 'null'
description: Total minutes played
Goals:
type:
- number
- 'null'
description: Total goals scored
Assists:
type:
- number
- 'null'
description: Total assists scored
Shots:
type:
- number
- 'null'
description: Total shots attempted
ShotsOnGoal:
type:
- number
- 'null'
description: Total shots on goal attempted
YellowCards:
type:
- number
- 'null'
description: Total yellow cards against
RedCards:
type:
- number
- 'null'
description: Total red cards against
YellowRedCards:
type:
- number
- 'null'
description: Total double yellow cards against (which result in a red card)
Crosses:
type:
- number
- 'null'
description: Total passes from a wide area of the field towards the center of the field near the opponent's goal
TacklesWon:
type:
- number
- 'null'
description: Total tackles won
Interceptions:
type:
- number
- 'null'
description: Total interceptions made
OwnGoals:
type:
- number
- 'null'
description: Total goals scored against own team (accidentally)
Fouls:
type:
- number
- 'null'
description: Total fouls made
Fouled:
type:
- number
- 'null'
description: Total times fouled
Offsides:
type:
- number
- 'null'
description: Total offsides against
Passes:
type:
- number
- 'null'
description: Total passes attempted
PassesCompleted:
type:
- number
- 'null'
description: Total passes completed successfully to teammate
LastManTackle:
type:
- number
- 'null'
description: Total tackles made when there is no one else available to stop the opponent from scoring (this can be the goalkeeper)
CornersWon:
type:
- number
- 'null'
description: Total corner kicks awarded
BlockedShots:
type:
- number
- 'null'
description: Total shots blocked
Touches:
type:
- number
- 'null'
description: Total times this player touched the ball
DefenderCleanSheets:
type:
- number
- 'null'
description: Total defender clean sheets (awarded when zero goals were allowed to the opponent and the player played at least 60 minutes)
GoalkeeperSaves:
type:
- number
- 'null'
description: Total saves made by goalkeeper
GoalkeeperGoalsAgainst:
type:
- number
- 'null'
description: Total goals allowed by goalkeeper
GoalkeeperSingleGoalAgainst:
type:
- number
- 'null'
description: Total games where this goalkeeper allowed exactly one goal
GoalkeeperCleanSheets:
type:
- number
- 'null'
description: Total goalkeeper clean sheets (awarded when zero goals were allowed to the opponent and the player played at least 60 minutes)
GoalkeeperWins:
type:
- number
- 'null'
description: Total goalkeeper wins (awarded when zero goals were allowed to the opponent and the player played at least 45 minutes)
PenaltyKickGoals:
type:
- number
- 'null'
description: Total penalty kick goals
PenaltyKickMisses:
type:
- number
- 'null'
description: Total penalty kick misses
PenaltyKickSaves:
type:
- number
- 'null'
des
# --- truncated at 32 KB (92 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sportsdataio/refs/heads/main/openapi/sportsdataio-soccer-v4-stats-api-openapi.yml