Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/sportsdataio-mlb-v3-projections-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: MLB MLB v3 Headshots MLB v3 Projections 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: MLB v3 Projections
paths:
/v3/mlb/projections/{format}/PlayerGameProjectionStatsByDate/{date}:
get:
description: SportsDataIO's proprietary projections, including DFS salary information and injuries, for fantasy players, called by date.
operationId: mlb_v3_projections_projected_player_game_stats___by_date
summary: Projected Player Game Stats - 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: date
in: path
description: 'The date of the game(s).
<br>Examples: <code>2017-JUL-31</code>, <code>2017-SEP-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerGameProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/PlayerSeasonProjectionStats/{season}:
get:
description: SportsDataIO's proprietary projections, including average draft position, for all active players for the season.
operationId: mlb_v3_projections_projected_player_season_stats_with_adp
summary: Projected Player Season Stats With ADP
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: season
in: path
description: 'Year of the season.
<br>Examples: <code>2017</code>, <code>2018</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PlayerSeasonProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/DfsSlatesByDate/{date}:
get:
description: Returns DFS Slates which have not yet started for which we have DFS projections.
operationId: mlb_v3_projections_dfs_slates___by_date
summary: DFS Slates - 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: date
in: path
description: 'The date of the slates.
<br>Examples: <code>2017-JUL-31</code>, <code>2017-SEP-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DfsSlate'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/InjuredPlayers:
get:
description: This endpoint provides all currently injured MLB players, along with injury details.
operationId: mlb_v3_projections_player_details___by_injured
summary: Player Details - by Injured
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
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Player'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/StartingLineupsByDate/{date}:
get:
description: Returns both projected and confirmed starting lineups for all games on a given date.
operationId: mlb_v3_projections_starting_lineups___by_date
summary: Starting 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: date
in: path
description: 'The date of the slates.
<br>Examples: <code>2017-JUL-31</code>, <code>2017-SEP-01</code>.'
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/StartingLineups'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/DepthCharts:
get:
description: Returns Depth Charts for all active MLB teams.
operationId: mlb_v3_projections_depth_charts
summary: Depth Charts
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
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TeamDepthChart'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/DfsSlateOwnershipProjectionsBySlateID/{slateId}:
get:
description: Slate Ownership Projections for a specific slate. Projections are for Guaranteed Prize Pool (GPP) format ownership. Will return an empty list if the slate is not yet projected or not a slate we have projections for.
operationId: mlb_v3_projections_dfs_slate_ownership_projections___by_slate
summary: DFS Slate Ownership Projections - by Slate
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: slateId
in: path
description: SlateID of the DFS Slate you wish to get ownership projections for. Will have an empty SlateOwnershipProjections if this slate was not projected
required: true
schema:
type: integer
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
/v3/mlb/projections/{format}/UpcomingDfsSlateOwnershipProjections:
get:
description: Returns DFS Slates which have not yet started for which we have DFS Ownership projections.
operationId: mlb_v3_projections_dfs_slate_ownership_projections___upcoming
summary: DFS Slate Ownership Projections - Upcoming
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
responses:
'200':
description: Success
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/DfsSlateWithOwnershipProjection'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
tags:
- MLB v3 Projections
components:
schemas:
TeamDepthChart:
properties:
DepthCharts:
type: array
items:
$ref: '#/components/schemas/DepthChart'
description: List of Depth Chart Records for Team
TeamID:
type: integer
description: The team's unique TeamID as assigned by SportsDataIO
Series:
properties:
HomeTeamWins:
type: integer
description: 'Number of wins by the home team on in the series. Note: this is for postseason series only.'
AwayTeamWins:
type: integer
description: 'Number of wins by the away team in the series. Note: This is for postseason series only.'
GameNumber:
type: integer
description: 'Game number in series. Note: this applies to postseason series only.'
MaxLength:
type: integer
description: 'Maximum number of games in the series. Note: this is for postseason series only.'
Unauthorized:
properties:
HttpStatusCode:
type: integer
Code:
type: integer
Description:
type: string
Help:
type: string
DfsSlatePlayer:
properties:
SlatePlayerID:
type: integer
description: Unique ID of a SlatePlayer (assigned by SportsDataIO)
SlateID:
type: integer
description: The SlateID that this SlatePlayer refers to
SlateGameID:
type:
- integer
- 'null'
description: The SlateGameID that this SlatePlayer refers to
PlayerID:
type:
- integer
- 'null'
description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career'
PlayerGameProjectionStatID:
type:
- integer
- 'null'
description: The SportsDataIO StatID that this SlatePlayer refers to. This points to data in the respective sports' projected player game stats feeds.
OperatorPlayerID:
type:
- string
- 'null'
description: Unique ID of the Player (assigned by the operator)
OperatorSlatePlayerID:
type:
- string
- 'null'
description: Unique ID of the SlatePlayer (assigned by the operator)
OperatorPlayerName:
type:
- string
- 'null'
description: The player's name (assigned by the operator)
OperatorPosition:
type:
- string
- 'null'
description: The player's eligible positions for the contest (assigned by the operator)
OperatorSalary:
type:
- integer
- 'null'
description: The player's salary for the contest (assigned by the operator)
OperatorRosterSlots:
type: array
items:
type:
- string
- 'null'
description: 'The player''s eligible positions to be played in the contest (assigned by the operator). Note: this would include UTIL; etc plays for those that are eligible.'
RemovedByOperator:
type:
- boolean
- 'null'
description: Indicates whether this player was removed/deleted by the operator
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO
DfsSlatePlayerOwnershipProjection:
properties:
SlateID:
type: integer
description: Unique ID of a Slate (assigned by SportsDataIO).
PlayerID:
type: integer
description: Unique ID of the Associated Player.
ProjectedOwnershipPercentage:
type: number
description: Projected Ownership Percentage (0-100)
IsCaptain:
type: boolean
description: Indicates if this is the MVP/Captain slot for single game slates
Player:
properties:
PlayerID:
type: integer
description: 'The player''s unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career'
SportsDataID:
type:
- string
- 'null'
description: Deprecated. Use SportRadarPlayerID instead.
Status:
type:
- string
- 'null'
description: 'Indicates the player''s status of being on an Major League Active Roster. Possible values include: Active, 40 Man Active, Non-Roster Invitee, Minors, Inactive, 7 Day Injury List, 10 Day Injury List, 15 Day Injury List, 60 Day Injury List, Restricted List, Paternity List, Bereavement List, Military List'
TeamID:
type:
- integer
- 'null'
description: The team's unique TeamID as assigned by SportsDataIO
Team:
type:
- string
- 'null'
description: The abbreviation [Key] of the team that the player belongs to
Jersey:
type:
- integer
- 'null'
description: The player's jersey number.
PositionCategory:
type:
- string
- 'null'
description: 'The player''s position category. Possible values: DH, IF, OF, P, PH, PR'
Position:
type:
- string
- 'null'
description: 'The player''s position associated with the given game or season. Possible values: 1B; 2B; 3B; C; CF; DH; IF; LF; OF; P; PH; PR; RF; RP; SP; SS'
MLBAMID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with MLB AM
FirstName:
type:
- string
- 'null'
description: The player's first name
LastName:
type:
- string
- 'null'
description: The player's last name
BatHand:
type:
- string
- 'null'
description: 'The player''s batting hand. Possible values: R, L, S'
ThrowHand:
type:
- string
- 'null'
description: 'The player''s throwing hand. Possible values: R, L, S'
Height:
type:
- integer
- 'null'
description: The player's height in inches
Weight:
type:
- integer
- 'null'
description: The weight of the player in pounds (lbs).
BirthDate:
type:
- string
- 'null'
description: The player's date of birth
BirthCity:
type:
- string
- 'null'
description: The city in which the player was born
BirthState:
type:
- string
- 'null'
description: 'The state in which the player was born. Note: State will be NULL for all countries outside of North America and Australia'
BirthCountry:
type:
- string
- 'null'
description: The country in which the player was born
HighSchool:
type:
- string
- 'null'
description: 'The high school that the player attended. Note: If the player attended a college, this field will be NULL'
College:
type:
- string
- 'null'
description: 'The college that the player attended. Note: If player did not attend college this field will contain "None" and a high school will be added if applicable'
ProDebut:
type:
- string
- 'null'
description: The date that this player made his MLB debut.
Salary:
type:
- integer
- 'null'
description: Field is expected to be NULL
PhotoUrl:
type:
- string
- 'null'
description: Field is expected to be NULL
SportRadarPlayerID:
type:
- string
- 'null'
description: The player's unique PlayerID for cross reference use with Stats Player
RotoworldPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with Rotoworld.
RotoWirePlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with RotoWire.
FantasyAlarmPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with FantasyAlarm
StatsPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with Stats Player.
SportsDirectPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to the SportsDirect data feeds, now part of Nielsen GraceNote.
XmlTeamPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with Xml Team
InjuryStatus:
type:
- string
- 'null'
description: 'The player''s current injury status; in the form of likelihood that player plays. Possible values: Probable; Questionable; Doubtful; Out'
InjuryBodyPart:
type:
- string
- 'null'
description: Indicates the player's injured body part. (e.g. ankle; knee; elbow; etc.)
InjuryStartDate:
type:
- string
- 'null'
description: The day that the injury started or first discovered.
InjuryNotes:
type:
- string
- 'null'
description: Brief description of the player's injury and expected availability
FanDuelPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with FanDuel
DraftKingsPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with DraftKings.
YahooPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with Yahoo
UpcomingGameID:
type:
- integer
- 'null'
description: The unique ID of a player's next upcoming game
FanDuelName:
type:
- string
- 'null'
description: The player's name on FanDuel
DraftKingsName:
type:
- string
- 'null'
description: The player's name on DraftKings
YahooName:
type:
- string
- 'null'
description: The player's name as displayed on/by Yahoo
GlobalTeamID:
type:
- integer
- 'null'
description: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
FantasyDraftName:
type:
- string
- 'null'
description: The player's name on Fantasy Draft
FantasyDraftPlayerID:
type:
- integer
- 'null'
description: The player's unique PlayerID for cross reference use with Fantasy Draft
Experience:
type:
- string
- 'null'
description: The player's years of experience
UsaTodayPlayerID:
type:
- integer
- 'null'
description: The player's cross reference PlayerID to USA Today headshot data feeds.
UsaTodayHeadshotUrl:
type:
- string
- 'null'
description: The player's headshot URL as provided by USA Today. License from USA Today is required.
UsaTodayHeadshotNoBackgroundUrl:
type:
- string
- 'null'
description: The player's transparent background headshot URL as provided by USA Today. License from USA Today is required.
UsaTodayHeadshotUpdated:
type:
- string
- 'null'
description: The last updated date of the player's headshot as provided by USA Today. License from USA Today is required.
UsaTodayHeadshotNoBackgroundUpdated:
type:
- string
- 'null'
description: The last updated date of the player's transparent background headshot as provided by USA Today. License from USA Today is required.
Inning:
properties:
InningID:
type: integer
description: The unique ID of this specific inning
GameID:
type: integer
description: The unique ID of the game tied to this Inning
InningNumber:
type: integer
description: The current inning number of the game
AwayTeamRuns:
type:
- integer
- 'null'
description: Number of runs scored by the away team in the specific inning
HomeTeamRuns:
type:
- integer
- 'null'
description: Number of runs scored by the home team in the specific inning
DfsSlateGame:
properties:
SlateGameID:
type: integer
description: The SlateGameID that this SlatePlayer refers to
SlateID:
type: integer
description: The SlateID that this SlateGame refers to
GameID:
type:
- integer
- 'null'
description: The unique ID of the game tied to this SlateGame
Game:
$ref: '#/components/schemas/Game'
description: The details of the Game that this SlateGame refers to
OperatorGameID:
type:
- integer
- 'null'
description: Unique ID of a SlateGame (assigned by the operator)
RemovedByOperator:
type:
- boolean
- 'null'
description: Indicates whether this game was removed/deleted by the operator.
Game:
properties:
GameID:
type: integer
description: The unique ID of this game
Season:
type: integer
description: The MLB season of the game
SeasonType:
type: integer
description: The type of season stage the game belongs to, e.g. Regular season, Post-season. For a description of possible values and how they work, see <a href="https://support.sportsdata.io/hc/en-us/articles/15196612633623-Process-Guide-Season-Types-and-Parameters" target="_blank">here.
Status:
type:
- string
- 'null'
description: The status of the game. For a description of possible values, see <a href="https://support.sportsdata.io/hc/en-us/articles/14287629964567-Process-Guide-Game-Status" target="_blank">here.</a> For how suspended and postponed games are handled specifically, see <a href="https://support.sportsdata.io/hc/en-us/articles/4404845580567-Postponed-and-Rescheduled-Games" target="_blank">here</a>.
Day:
type:
- string
- 'null'
description: The date of the game
DateTime:
type:
- string
- 'null'
description: The date and time of the game (in US Eastern Time)
AwayTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the away team
HomeTeam:
type:
- string
- 'null'
description: The abbreviation [Key] of the home team
AwayTeamID:
type: integer
description: The unique TeamID of the away team
HomeTeamID:
type: integer
description: The unique ID of the home team
RescheduledGameID:
type:
- integer
- 'null'
description: The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling.
StadiumID:
type:
- integer
- 'null'
description: The unique ID of the stadium
Channel:
type:
- string
- 'null'
description: The television station broadcasting the game
Inning:
type:
- integer
- 'null'
description: 'The inning that the game is currently in, or the inning in which the game ended. Possible values include: NULL, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, etc)'
InningHalf:
type:
- string
- 'null'
description: 'The inning half that the game is currently in; or the inning half in which the game ended (possible values: T; B; E: M: NULL)'
AwayTeamRuns:
type:
- integer
- 'null'
description: Number of runs scored by the away team in the game
HomeTeamRuns:
type:
- integer
- 'null'
description: Number of runs scored by the home team in the game
AwayTeamHits:
type:
- integer
- 'null'
description: Total hits by the away team in the game
HomeTeamHits:
type:
- integer
- 'null'
description: Total hits by the home team in the game
AwayTeamErrors:
type:
- integer
- 'null'
description: Total errors committed by the away team in the game
HomeTeamErrors:
type:
- integer
- 'null'
description: Total errors committed by the home team in the game
WinningPitcherID:
type:
- integer
- 'null'
description: The PlayerID of the pitcher who recorded the win in the game
LosingPitcherID:
type:
- integer
- 'null'
description: The PlayerID of the losing pitcher in the game
SavingPitcherID:
type:
- integer
- 'null'
description: The PlayerID of the pitcher who recorded the save in the game
Attendance:
type:
- integer
- 'null'
description: Total number of people who attended the game
AwayTeamProbablePitcherID:
type:
- integer
- 'null'
description: The PlayerID of the away team's probable pitcher
HomeTeamProbablePitcherID:
type:
- integer
- 'null'
description: The PlayerID of the home team's probable pitcher
Outs:
type:
- integer
- 'null'
description: The number of outs recorded in the current inning of the game
Balls:
type:
- integer
- 'null'
description: The number of balls thrown for the current at bat
Strikes:
type:
- integer
- 'null'
description: The number of strikes thrown for the current at bat
CurrentPitcherID:
type:
- integer
- 'null'
description: The PlayerID of the current pitcher
CurrentHitterID:
type:
- integer
- 'null'
description: The PlayerID of the current hitter
AwayTeamStartingPitcherID:
type:
- integer
- 'null'
description: The PlayerID of the away team's starting pitcher
HomeTeamStartingPitcherID:
type:
- integer
- 'null'
description: The PlayerID of the home team starting pitcher in the game
CurrentPitchingTeamID:
type:
- integer
- 'null'
description: The TeamID of the current pitcher's team
CurrentHittingTeamID:
type:
- integer
- 'null'
description: The TeamID of the current hitter's team
PointSpread:
type:
- number
- 'null'
description: 'The consensus Run Line at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field''s negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the run line is contingent on the bet line). Note: In MLB, Point Spread may also be referred to as Run Line'
OverUnder:
type:
- number
- 'null'
description: The oddsmaker total points line at game start
AwayTeamMoneyLine:
type:
- integer
- 'null'
description: Moneyline from the perspective of the away team
HomeTeamMoneyLine:
type:
- integer
- 'null'
description: Moneyline from the perspective of the home team
ForecastTempLow:
type:
- integer
- 'null'
description: The forecasted low temperature on game day at this venue (in Fahrenheit)
ForecastTempHigh:
type:
- integer
- 'null'
description: The forecasted high temperature on game day at this venue (in Fahrenheit)
ForecastDescription:
type:
- string
- 'null'
description: 'The description of the weather forecast. Posible values include: Broken Clouds, Clear Sky, Few Clouds, Heavy Intensity Rain, Light Rain, Moderate Rain, Mostly Cloudy, Mostly Sunny, Overcast Clouds, Partly Cloudy, Scattered Clouds, Showers, Thunderstorms'
ForecastWindChill:
type:
- integer
- 'null'
description: The forecasted wind chill on game day at this venue.
ForecastWindSpeed:
type:
- integer
- 'null'
description: The forecasted wind speed on game day at this venue.
ForecastWindDirection:
type:
- integer
- 'null'
description: The wind direction isn't baseball specific. It refers to the direction that the wind is coming from. 90 would be wind coming from the east. 180 is wind from the south. 270 is a wind from the west ... and so on.
RescheduledFromGameID:
type:
# --- truncated at 32 KB (84 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sportsdataio/refs/heads/main/openapi/sportsdataio-mlb-v3-projections-api-openapi.yml