{
"opencollection": "1.0.0",
"info": {
"name": "Stats API Documentation",
"version": "2.0.0"
},
"items": [
{
"info": {
"name": "Attendance",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get team attendance",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/attendance",
"params": [
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get team attendance"
},
{
"info": {
"name": "Get team attendance",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/attendance",
"params": [
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get team attendance"
}
]
},
{
"info": {
"name": "Teams",
"type": "folder"
},
"items": [
{
"info": {
"name": "View all team alumni",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/alumni",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View all team alumni"
},
{
"info": {
"name": "updateAlumni",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/alumni",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
}
},
{
"info": {
"name": "View stats for an individual team. ",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/stats",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "sortStat",
"value": "",
"type": "query",
"description": "Baseball stat to sort splits by."
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "groupBy",
"value": "",
"type": "query",
"description": "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "opposingPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team"
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View stats for an individual team. "
},
{
"info": {
"name": "View a teams info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/roster",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "rosterType",
"value": "",
"type": "path",
"description": "Type of roster. Available types in /api/v1/rosterTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "View a teams info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/roster/:rosterType",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "rosterType",
"value": "",
"type": "path",
"description": "Type of roster. Available types in /api/v1/rosterTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "View all coaches for a team",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/personnel",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View all coaches for a team"
},
{
"info": {
"name": "View team stat leaders",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/leaders",
"params": [
{
"name": "teamId",
"value": "",
"type": "path"
},
{
"name": "leaderCategories",
"value": "",
"type": "query"
},
{
"name": "season",
"value": "",
"type": "query"
},
{
"name": "leaderGameTypes",
"value": "",
"type": "query"
},
{
"name": "expand",
"value": "",
"type": "query"
},
{
"name": "limit",
"value": "",
"type": "query"
},
{
"name": "offset",
"value": "",
"type": "query"
},
{
"name": "playerPool",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View team stat leaders"
},
{
"info": {
"name": "View historical records for a list of teams",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/history",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "startSeason",
"value": "",
"type": "query",
"description": "Start date for range of data (used with end date optionally). Example: '2018' or '2018.2'"
},
{
"name": "endSeason",
"value": "",
"type": "query",
"description": "End date for range of data (used with start date optionally). Format: '2018' or '2018.2'"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View historical records for a list of teams"
},
{
"info": {
"name": "View historical records for a list of teams",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/history",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "startSeason",
"value": "",
"type": "query",
"description": "Start date for range of data (used with end date optionally). Example: '2018' or '2018.2'"
},
{
"name": "endSeason",
"value": "",
"type": "query",
"description": "End date for range of data (used with start date optionally). Format: '2018' or '2018.2'"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View historical records for a list of teams"
},
{
"info": {
"name": "View all coaches for a team",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/coaches",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View all coaches for a team"
},
{
"info": {
"name": "View team and affiliate teams",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId/affiliates",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View team and affiliate teams"
},
{
"info": {
"name": "View team and affiliate teams",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/affiliates",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View team and affiliate teams"
},
{
"info": {
"name": "View a teams stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/stats",
"params": [
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "sortStat",
"value": "",
"type": "query",
"description": "Baseball stat to sort splits by."
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "daysBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' days (Starting from yesterday)."
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "combineSits",
"value": "",
"type": "query",
"description": "If true, gathers stats where all of the situational criteria are met. If false, returns stats where any of the situational criteria are met. Default: false"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View a teams stats"
},
{
"info": {
"name": "View leaders for team stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/stats/leaders",
"params": [
{
"name": "leaderCategories",
"value": "",
"type": "query",
"description": "TBD"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "statType",
"value": "",
"type": "query"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "statGroup",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "daysBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' days (Starting from yesterday)."
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View leaders for team stats"
},
{
"info": {
"name": "View info for all teams",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "divisionId",
"value": "",
"type": "query",
"description": "Unique Division Identifier"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching teams that are currently active (Y), inactive (N), pending (P), or all teams (B)"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "allStarStatuses",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "View info for all teams",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/teams/:teamId",
"params": [
{
"name": "teamId",
"value": "",
"type": "path",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "divisionId",
"value": "",
"type": "query",
"description": "Unique Division Identifier"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching teams that are currently active (Y), inactive (N), pending (P), or all teams (B)"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "allStarStatuses",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
}
]
},
{
"info": {
"name": "Schedule",
"type": "folder"
},
"items": [
{
"info": {
"name": "postseasonSchedule_1",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/postseason",
"params": [
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "seriesNumber",
"value": "",
"type": "query"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "useFeaturedGame",
"value": "",
"type": "query"
},
{
"name": "season",
"value": "",
"type": "query"
},
{
"name": "publicFacing",
"value": "",
"type": "query",
"description": "Return public, non-public or all games. Format: Public Facing = 'Y', Non-Public Facing = 'N', All = 'A'"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull postseason schedules"
},
{
"info": {
"name": "postseasonSchedule",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/schedule/postseason",
"params": [
{
"name": "season",
"value": "",
"type": "query"
}
]
}
},
{
"info": {
"name": "trackingEventsSchedule",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/trackingEvents",
"params": [
{
"name": "calendarTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of calendar types"
},
{
"name": "eventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of events. Note: Don't Use. This will be deprecated in favor of calendarTypes"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "eventIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-game event"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "performerIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-team event performers"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "opponentId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "publicFacing",
"value": "",
"type": "query",
"description": "Return public, non-public or all games. Format: Public Facing = 'Y', Non-Public Facing = 'N', All = 'A'"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull schedules for tracking events"
},
{
"info": {
"name": "schedulePrivate",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/private",
"params": [
{
"name": "calendarTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of calendar types"
},
{
"name": "eventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of events. Note: Don't Use. This will be deprecated in favor of calendarTypes"
},
{
"name": "scheduleEventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of event types"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "eventIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-game event"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "performerIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-team event performers"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "opponentId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "publicFacing",
"value": "",
"type": "query",
"description": "Return public, non-public or all games. Format: Public Facing = 'Y', Non-Public Facing = 'N', All = 'A'"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull schedules with authentication enforced and a \"no-cache\" cache-control policy"
},
{
"info": {
"name": "schedulePrivate_1",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/private/:scheduleType",
"params": [
{
"name": "calendarTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of calendar types"
},
{
"name": "eventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of events. Note: Don't Use. This will be deprecated in favor of calendarTypes"
},
{
"name": "scheduleEventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of event types"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "eventIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-game event"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "performerIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-team event performers"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "opponentId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "publicFacing",
"value": "",
"type": "query",
"description": "Return public, non-public or all games. Format: Public Facing = 'Y', Non-Public Facing = 'N', All = 'A'"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull schedules with authentication enforced and a \"no-cache\" cache-control policy"
},
{
"info": {
"name": "tuneIn",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/postseason/tuneIn",
"params": [
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull postseason schedules"
},
{
"info": {
"name": "postseasonScheduleSeries",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/postseason/series",
"params": [
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "seriesNumber",
"value": "",
"type": "query"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "useFeaturedGame",
"value": "",
"type": "query"
},
{
"name": "season",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull postseason schedules"
},
{
"info": {
"name": "tieGames",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/games/tied",
"params": [
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull tie game schedules for the given season"
},
{
"info": {
"name": "schedule",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule",
"params": [
{
"name": "calendarTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of calendar types"
},
{
"name": "eventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of events. Note: Don't Use. This will be deprecated in favor of calendarTypes"
},
{
"name": "scheduleEventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of event types"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "eventIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-game event"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "performerIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-team event performers"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "opponentId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "publicFacing",
"value": "",
"type": "query",
"description": "Return public, non-public or all games. Format: Public Facing = 'Y', Non-Public Facing = 'N', All = 'A'"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View schedule info. This endpoint allows you to pull schedules"
},
{
"info": {
"name": "schedule_1",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/schedule/:scheduleType",
"params": [
{
"name": "calendarTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of calendar types"
},
{
"name": "eventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of events. Note: Don't Use. This will be deprecated in favor of calendarTypes"
},
{
"name": "scheduleEventTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of event types"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "eventIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-game event"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "performerIds",
"value": "",
"type": "query",
"description": "A unique identifier for non-team event performers"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "useLatestGames",
"value": "",
"type": "query"
},
{
"name": "opponentId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "publicFacing",
"value": "",
"type": "query",
"description": "Return public, non-public or all games. Format: Public Facing = 'Y', Non-Public Facing = 'N', All = 'A'"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View schedule info. This endpoint allows you to pull schedules"
}
]
},
{
"info": {
"name": "League",
"type": "folder"
},
"items": [
{
"info": {
"name": "View league info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/league",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching leagues that are currently active (Y), inactive (N), pending (P), or all teams (B)"
}
]
},
"docs": "View league info"
},
{
"info": {
"name": "Update league cache",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/league",
"params": [
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
}
]
},
"docs": "Update league cache"
},
{
"info": {
"name": "View league info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagues",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching leagues that are currently active (Y), inactive (N), pending (P), or all teams (B)"
}
]
},
"docs": "View league info"
},
{
"info": {
"name": "Update league cache",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/leagues",
"params": [
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
}
]
},
"docs": "Update league cache"
},
{
"info": {
"name": "All-Star write-ins",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/league/:leagueId/allStarWriteIns",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star write-ins"
},
{
"info": {
"name": "All-Star write-ins",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagues/:leagueId/allStarWriteIns",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star write-ins"
},
{
"info": {
"name": "All-Star final vote",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/league/:leagueId/allStarFinalVote",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star final vote"
},
{
"info": {
"name": "All-Star final vote",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagues/:leagueId/allStarFinalVote",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star final vote"
},
{
"info": {
"name": "All-Star Ballot",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/league/allStarBallot",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star Ballot"
},
{
"info": {
"name": "All-Star Ballot",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/league/:leagueId/allStarBallot",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star Ballot"
},
{
"info": {
"name": "All-Star Ballot",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagues/allStarBallot",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star Ballot"
},
{
"info": {
"name": "All-Star Ballot",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagues/:leagueId/allStarBallot",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "All-Star Ballot"
},
{
"info": {
"name": "View league info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/league/:leagueId",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching leagues that are currently active (Y), inactive (N), pending (P), or all teams (B)"
}
]
},
"docs": "View league info"
},
{
"info": {
"name": "View league info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagues/:leagueId",
"params": [
{
"name": "leagueId",
"value": "",
"type": "path",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching leagues that are currently active (Y), inactive (N), pending (P), or all teams (B)"
}
]
},
"docs": "View league info"
}
]
},
{
"info": {
"name": "Config",
"type": "folder"
},
"items": [
{
"info": {
"name": "List all job types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/jobTypes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all job types"
},
{
"info": {
"name": "updateJobTypes",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/jobTypes"
}
},
{
"info": {
"name": "List all status types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/gameStatus"
},
"docs": "List all status types"
},
{
"info": {
"name": "Clear all status types",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/gameStatus"
},
"docs": "Clear all status types"
},
{
"info": {
"name": "List all wind direction options",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/windDirection",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all wind direction options"
},
{
"info": {
"name": "List all weather trajectories",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/weatherTrajectoryConfidences"
},
"docs": "List all weather trajectories"
},
{
"info": {
"name": "View available violationType options",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/violationTypes"
},
"docs": "View available violationType options"
},
{
"info": {
"name": "List all hit trajectories",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/transactionTypes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all hit trajectories"
},
{
"info": {
"name": "List all tracking versions",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/trackingVersions"
},
"docs": "List all tracking versions"
},
{
"info": {
"name": "List all tracking vendors",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/trackingVendors"
},
"docs": "List all tracking vendors"
},
{
"info": {
"name": "List stat search stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/search/stats",
"params": [
{
"name": "Categories of filters for stat search",
"value": "",
"type": "query"
}
]
},
"docs": "List stat search stats"
},
{
"info": {
"name": "List stat search parameters",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/search/params",
"params": [
{
"name": "Categories of filters for stat search",
"value": "",
"type": "query"
}
]
},
"docs": "List stat search parameters"
},
{
"info": {
"name": "List groupBy types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/search/groupByTypes",
"params": [
{
"name": "Categories of filters for stat search",
"value": "",
"type": "query"
}
]
},
"docs": "List groupBy types"
},
{
"info": {
"name": "Stats Search Config Endpoint",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/search/config",
"params": [
{
"name": "Categories of filters for stat search",
"value": "",
"type": "query"
},
{
"name": "Category of statistic to return. Available types in /api/v1/statGroups",
"value": "",
"type": "query"
}
]
},
"docs": "Stats Search Config Endpoint"
},
{
"info": {
"name": "List all statcast position types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/statcastPositionTypes"
},
"docs": "List all statcast position types"
},
{
"info": {
"name": "List all stat types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/statTypes"
},
"docs": "List all stat types"
},
{
"info": {
"name": "List all stat groups",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/statGroups"
},
"docs": "List all stat groups"
},
{
"info": {
"name": "List all stat fields",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/statFields"
},
"docs": "List all stat fields"
},
{
"info": {
"name": "List all standings types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/standingsTypes"
},
"docs": "List all standings types"
},
{
"info": {
"name": "List all stat fields",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/sortModifiers"
},
"docs": "List all stat fields"
},
{
"info": {
"name": "List all sky options",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/sky",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all sky options"
},
{
"info": {
"name": "List all situation codes",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/situationCodes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
},
{
"name": "Season of play",
"value": "",
"type": "query"
},
{
"name": "Category of statistic to return. Available types in /api/v1/statGroups",
"value": "",
"type": "query"
}
]
},
"docs": "List all situation codes"
},
{
"info": {
"name": "List all possible schedule types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/scheduleTypes"
},
"docs": "List all possible schedule types"
},
{
"info": {
"name": "List all event types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/scheduleEventTypes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all event types"
},
{
"info": {
"name": "List runner detail types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/runnerDetailTypes"
},
"docs": "List runner detail types"
},
{
"info": {
"name": "List all ruleSettings",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/ruleSettings"
},
"docs": "List all ruleSettings"
},
{
"info": {
"name": "List all possible roster types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/rosterTypes"
},
"docs": "List all possible roster types"
},
{
"info": {
"name": "List all roof types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/roofTypes"
},
"docs": "List all roof types"
},
{
"info": {
"name": "List all replay review reasons",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/reviewReasons",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all replay review reasons"
},
{
"info": {
"name": "List all possible positions",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/positions"
},
"docs": "List all possible positions"
},
{
"info": {
"name": "List all player status codes",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/playerStatusCodes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all player status codes"
},
{
"info": {
"name": "List all possible platforms",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/platforms"
},
"docs": "List all possible platforms"
},
{
"info": {
"name": "List all pitch classification types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/pitchTypes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all pitch classification types"
},
{
"info": {
"name": "List all pitch codes",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/pitchCodes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all pitch codes"
},
{
"info": {
"name": "List all possible performer types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/performerTypes"
},
"docs": "List all possible performer types"
},
{
"info": {
"name": "List all possible metrics",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/metrics"
},
"docs": "List all possible metrics"
},
{
"info": {
"name": "View all lookup values",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/lookup/values/all"
},
"docs": "View all lookup values"
},
{
"info": {
"name": "List all logical event types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/logicalEvents",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all logical event types"
},
{
"info": {
"name": "List all possible player league leader types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/leagueLeaderTypes"
},
"docs": "List all possible player league leader types"
},
{
"info": {
"name": "List all support languages",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/languages"
},
"docs": "List all support languages"
},
{
"info": {
"name": "List all hit trajectories",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/hitTrajectories",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all hit trajectories"
},
{
"info": {
"name": "List groupBy types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/groupByTypes"
},
"docs": "List groupBy types"
},
{
"info": {
"name": "List all gameday types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/gamedayTypes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all gameday types"
},
{
"info": {
"name": "List all game types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/gameTypes",
"params": [
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "Unique League Identifier",
"value": "",
"type": "query"
},
{
"name": "Season of play",
"value": "",
"type": "query"
}
]
},
"docs": "List all game types"
},
{
"info": {
"name": "List fielder detail types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/fielderDetailTypes"
},
"docs": "List fielder detail types"
},
{
"info": {
"name": "List all event types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/eventTypes",
"params": [
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "List all event types"
},
{
"info": {
"name": "List all possible event status types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/eventStatus"
},
"docs": "List all possible event status types"
},
{
"info": {
"name": "List all tracking vendors",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/coachingVideoTypes"
},
"docs": "List all tracking vendors"
},
{
"info": {
"name": "List all baseball stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/baseballStats"
},
"docs": "List all baseball stats"
}
]
},
{
"info": {
"name": "Analytics",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get the field tracking data for a specific play. ",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:guid/contextMetricsAverages",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "guid",
"value": "",
"type": "path",
"description": "Unique identifier for a play within a game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing raw coordinate data and refined calculated metrics.
This responses can be very large, so it is strongly recommended that you pass \"Accept-Encoding: gzip\" as a header to have the responses compressed."
},
{
"info": {
"name": "Get the field tracking data for a specific play. ",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:guid/contextMetricsAverages",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "guid",
"value": "",
"type": "path",
"description": "Unique identifier for a play within a game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing raw coordinate data and refined calculated metrics.
This responses can be very large, so it is strongly recommended that you pass \"Accept-Encoding: gzip\" as a header to have the responses compressed."
},
{
"info": {
"name": "Get the field tracking data for a specific play. ",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:guid/homeRunBallparks",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "guid",
"value": "",
"type": "path",
"description": "Unique identifier for a play within a game"
},
{
"name": "isHomeRunParks",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing raw coordinate data and refined calculated metrics.
This responses can be very large, so it is strongly recommended that you pass \"Accept-Encoding: gzip\" as a header to have the responses compressed."
},
{
"info": {
"name": "Get the field tracking data for a specific play. ",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:guid/contextMetrics",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "guid",
"value": "",
"type": "path",
"description": "Unique identifier for a play within a game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing raw coordinate data and refined calculated metrics.
This responses can be very large, so it is strongly recommended that you pass \"Accept-Encoding: gzip\" as a header to have the responses compressed."
},
{
"info": {
"name": "Tracking data by play/guid",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:guid/analytics",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "guid",
"value": "",
"type": "path",
"description": "Unique identifier for a play within a game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing raw coordinate data and refined calculated metrics.
This responses can be very large, so it is strongly recommended that you pass \"Accept-Encoding: gzip\" as a header to have the responses compressed."
},
{
"info": {
"name": "Get play GUIDs by game",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/guids",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "gameModeId",
"value": "",
"type": "query",
"description": "Statcast game mode. Format: 0 = Batting Practive, 1 = Warmup 2 = Live"
},
{
"name": "isPitch",
"value": "",
"type": "query",
"description": "If there was a pitch"
},
{
"name": "isHit",
"value": "",
"type": "query",
"description": "If there was a hit ball tracked"
},
{
"name": "isPickoff",
"value": "",
"type": "query",
"description": "If there was a pickoff"
},
{
"name": "hasUpdates",
"value": "",
"type": "query",
"description": "True if updated by an auditor"
},
{
"name": "since",
"value": "",
"type": "query",
"description": "Returns all data that was created after the specified timestamp. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "updatedSince",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastPlayTime",
"value": "",
"type": "query",
"description": "Returns all data that was created after the specified timestamp. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastMetricsUpdatedTime",
"value": "",
"type": "query",
"description": "The last time the metrics were built for this play"
},
{
"name": "lastAuditUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastVideoUpdatedTime",
"value": "",
"type": "query",
"description": "The last time SportyBot video was updated"
}
]
},
"docs": "This endpoint returns Statcast data for all plays in a specific game."
},
{
"info": {
"name": "Get the last pitch for a list of games",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/lastPitch",
"params": [
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get the last pitch for a list of games"
},
{
"info": {
"name": "Tracking data by date/time",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/analytics/guids",
"params": [
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "gameModeId",
"value": "",
"type": "query",
"description": "Statcast game mode. Format: 0 = Batting Practive, 1 = Warmup 2 = Live"
},
{
"name": "isPitch",
"value": "",
"type": "query",
"description": "If there was a pitch"
},
{
"name": "isHit",
"value": "",
"type": "query",
"description": "If there was a hit ball tracked"
},
{
"name": "isPickoff",
"value": "",
"type": "query",
"description": "If there was a pickoff"
},
{
"name": "isNonStatcast",
"value": "",
"type": "query",
"description": "If non statcast games need to be included"
},
{
"name": "gamedayType",
"value": "",
"type": "query",
"description": "Indicates the level of Gameday (tracking, play-by-play, linescore, etc...)"
},
{
"name": "hasUpdates",
"value": "",
"type": "query",
"description": "True if updated by an auditor"
},
{
"name": "lastPlayTime",
"value": "",
"type": "query",
"description": "Returns all data that was created after the specified timestamp. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastMetricsUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastAuditUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastVideoUpdatedTime",
"value": "",
"type": "query",
"description": "The last time SportyBot video was updated"
},
{
"name": "gameDate",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Sort the set of data by the specified field"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
}
]
},
"docs": "Tracking data by date/time"
},
{
"info": {
"name": "Get tracking metadata for games",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/analytics/game",
"params": [
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "gameModeId",
"value": "",
"type": "query",
"description": "Statcast game mode. Format: 0 = Batting Practive, 1 = Warmup 2 = Live"
},
{
"name": "isPitch",
"value": "",
"type": "query",
"description": "If there was a pitch"
},
{
"name": "isHit",
"value": "",
"type": "query",
"description": "If there was a hit ball tracked"
},
{
"name": "isPickoff",
"value": "",
"type": "query",
"description": "If there was a pickoff"
},
{
"name": "isNonStatcast",
"value": "",
"type": "query",
"description": "If non statcast games need to be included"
},
{
"name": "gamedayType",
"value": "",
"type": "query",
"description": "Indicates the level of Gameday (tracking, play-by-play, linescore, etc...)"
},
{
"name": "hasUpdates",
"value": "",
"type": "query",
"description": "True if updated by an auditor"
},
{
"name": "lastPlayTime",
"value": "",
"type": "query",
"description": "Returns all data that was created after the specified timestamp. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastVideoUpdatedTime",
"value": "",
"type": "query",
"description": "The last time SportyBot video was updated"
},
{
"name": "lastUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastMetricsUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "lastAuditUpdatedTime",
"value": "",
"type": "query",
"description": "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "gameDate",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Sort the set of data by the specified field"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
}
]
},
"docs": "Get tracking metadata for games"
}
]
},
{
"info": {
"name": "Weather",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get full weather for a venue.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/weather/venues/:venueId/full",
"params": [
{
"name": "venueId",
"value": "",
"type": "path",
"description": "Unique Venue Identifier"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing full weather for a specific venue."
},
{
"info": {
"name": "Get basic weather for a venue.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/weather/venues/:venueId/basic",
"params": [
{
"name": "venueId",
"value": "",
"type": "path",
"description": "Unique Venue Identifier"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing basic weather for a specific venue."
},
{
"info": {
"name": "Get the raw field weather data.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/weather/game/:gamePk/:playId",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "playId",
"value": "",
"type": "path",
"description": "Unique identifier for a play within a game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing weather for the current play."
},
{
"info": {
"name": "Get the weather forecast for a game.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/weather/game/:gamePk/forecast/:roofType",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "roofType",
"value": "",
"type": "path",
"description": "Venue roof type"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Returns a json file containing the weather forecast for a specific game."
}
]
},
{
"info": {
"name": "Venues",
"type": "folder"
},
"items": [
{
"info": {
"name": "View venue info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/venues",
"params": [
{
"name": "venueId",
"value": "",
"type": "path",
"description": "Unique Venue Identifier"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique venue identifiers"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "active",
"value": "",
"type": "query",
"description": "Whether or not a player is active"
},
{
"name": "includeEvents",
"value": "",
"type": "query"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
}
]
},
"docs": "This endpoint allows you to pull venues"
},
{
"info": {
"name": "View venue info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/venues/:venueId",
"params": [
{
"name": "venueId",
"value": "",
"type": "path",
"description": "Unique Venue Identifier"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique venue identifiers"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "active",
"value": "",
"type": "query",
"description": "Whether or not a player is active"
},
{
"name": "includeEvents",
"value": "",
"type": "query"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
}
]
},
"docs": "This endpoint allows you to pull venues"
}
]
},
{
"info": {
"name": "Transactions",
"type": "folder"
},
"items": [
{
"info": {
"name": "View transaction info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/transactions",
"params": [
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "playerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "transactionIds",
"value": "",
"type": "query"
},
{
"name": "transactionTypes",
"value": "",
"type": "query"
},
{
"name": "divisionIds",
"value": "",
"type": "query"
},
{
"name": "order",
"value": "",
"type": "query"
},
{
"name": "limit",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull transactions."
}
]
},
{
"info": {
"name": "Streaks",
"type": "folder"
},
"items": [
{
"info": {
"name": "View streaks",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/streaks",
"params": [
{
"name": "streakOrg",
"value": "",
"type": "query"
},
{
"name": "streakStat",
"value": "",
"type": "query"
},
{
"name": "streakSpan",
"value": "",
"type": "query"
},
{
"name": "streakLevel",
"value": "",
"type": "query"
},
{
"name": "streakThreshold",
"value": "",
"type": "query"
},
{
"name": "inverse",
"value": "",
"type": "query"
},
{
"name": "startersOnly",
"value": "",
"type": "query"
},
{
"name": "statGroup",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "activeStreak",
"value": "",
"type": "query",
"description": "Whether or not a player is active"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View streaks"
},
{
"info": {
"name": "View streaks parameter options",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/streaks/types"
},
"docs": "View streaks parameter options"
}
]
},
{
"info": {
"name": "Stats",
"type": "folder"
},
"items": [
{
"info": {
"name": "View stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats",
"params": [
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "personId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "metrics",
"value": "",
"type": "query",
"description": "Name of metric(s) for metric log stats. Available metrics in /api/v1/metrics"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "batterTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the batter's team"
},
{
"name": "pitcherTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the pitcher's team"
},
{
"name": "batterId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "pitcherId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "combineSits",
"value": "",
"type": "query",
"description": "If true, gathers stats where all of the situational criteria are met. If false, returns stats where any of the situational criteria are met. Default: false"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "fields",
"value": "",
"type": "query"
},
{
"name": "sortStat",
"value": "",
"type": "query",
"description": "Baseball stat to sort splits by."
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "playerPool",
"value": "",
"type": "query",
"description": "Return \"ALL\" or only \"QUALIFIED\" players based on plate appearances."
},
{
"name": "position",
"value": "",
"type": "query",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "daysBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' days (Starting from yesterday)."
},
{
"name": "gamesBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' games played."
},
{
"name": "excludeTradedPlayers",
"value": "",
"type": "query",
"description": "Excludes players who have since been traded from the input team"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
}
]
},
"docs": "View stats"
},
{
"info": {
"name": "View stats from search",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/search",
"params": [
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "playIds",
"value": "",
"type": "query",
"description": "Comma delimited list of unique play identifiers"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "pitcherTeamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "batterTeamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "pitcherSportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "batterSportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "pitcherLeagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "batterLeagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "divisionIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique League Identifiers"
},
{
"name": "pitcherDivisionIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique League Identifiers"
},
{
"name": "batterDivisionIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique League Identifiers"
},
{
"name": "pitchersOnTeamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "battersOnTeamIds",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "playerIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "playerPool",
"value": "",
"type": "query",
"description": "Return \"ALL\" or only \"QUALIFIED\" players based on plate appearances."
},
{
"name": "pitcherIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "batterIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "catcherIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "firstBasemanIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "secondBasemanIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "thirdBasemanIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "shortstopIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "leftFielderIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "centerFielderIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "rightFielderIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "runnerFirstIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "runnerSecondIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "runnerThirdIds",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "pitchHand",
"value": "",
"type": "query",
"description": "Handedness of pitcher"
},
{
"name": "batSide",
"value": "",
"type": "query",
"description": "Bat side of hitter"
},
{
"name": "pitchTypes",
"value": "",
"type": "query",
"description": "Classification of pitch (fastball, curveball, etc...)"
},
{
"name": "pitchCodes",
"value": "",
"type": "query",
"description": "Result of the pitch (ball, called strike, etc...)"
},
{
"name": "eventTypes",
"value": "",
"type": "query",
"description": "Type of event"
},
{
"name": "positions",
"value": "",
"type": "query",
"description": "All of the details of a player's position"
},
{
"name": "primaryPositions",
"value": "",
"type": "query",
"description": "All of the details of a player's position"
},
{
"name": "minPitchSpeed",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxPitchSpeed",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minSpinRate",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxSpinRate",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minExtension",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxExtension",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minExitVelocityAgainst",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxExitVelocityAgainst",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minLaunchAngleAgainst",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxLaunchAngleAgainst",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minExitVelocity",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxExitVelocity",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minLaunchAngle",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxLaunchAngle",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minHomeRunDistance",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxHomeRunDistance",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minHitDistance",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxHitDistance",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minHangTime",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxHangTime",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minHitProbability",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxHitProbability",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "minCatchProbability",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxCatchProbability",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "isBarrel",
"value": "",
"type": "query",
"description": "Whether or not a play resulted in a barreled ball"
},
{
"name": "hitTrajectories",
"value": "",
"type": "query",
"description": "Trajectory of hit (line drive, fly ball, etc...)"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "groupBy",
"value": "",
"type": "query",
"description": "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
},
{
"name": "compareOver",
"value": "",
"type": "query",
"description": "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
},
{
"name": "sortStat",
"value": "",
"type": "query",
"description": "Baseball stat to sort splits by."
},
{
"name": "sortModifier",
"value": "",
"type": "query",
"description": "The prefix modifier for the sort stat. avg, min, max. I.E minExitVelocity, maxLaunchAngle, avgHitDistance"
},
{
"name": "sortOrder",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "percentile",
"value": "",
"type": "query",
"description": "Only return averages above this percentile. used for best effort plays"
},
{
"name": "minOccurrences",
"value": "",
"type": "query",
"description": "Minimum occurrences to filter upon"
},
{
"name": "minPlateAppearances",
"value": "",
"type": "query",
"description": "Minimum occurrences to filter upon"
},
{
"name": "minInnings",
"value": "",
"type": "query",
"description": "Minimum occurrences to filter upon"
},
{
"name": "qualifierRate",
"value": "",
"type": "query",
"description": "Minimum occurrences to filter upon"
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "showTotals",
"value": "",
"type": "query",
"description": "Columns to return totals"
},
{
"name": "includeNullMetrics",
"value": "",
"type": "query",
"description": "Show events with null metrics"
},
{
"name": "statFields",
"value": "",
"type": "query",
"description": "Baseball stat fields to populate"
},
{
"name": "atBatNumbers",
"value": "",
"type": "query",
"description": "The at bat number of a given game. Format: 1, 2, 3, etc"
},
{
"name": "pitchNumbers",
"value": "",
"type": "query",
"description": "The pitch number of a given game. Format: 1, 2, 3, etc"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "debug",
"value": "",
"type": "query"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Whether or not a player is active"
}
]
},
"docs": "View stats from search"
},
{
"info": {
"name": "View metric stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/metrics",
"params": [
{
"name": "personId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "personIds",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "batterId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "pitcherId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "opposingPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team"
},
{
"name": "position",
"value": "",
"type": "query",
"description": "All of the details of a player's position"
},
{
"name": "eventType",
"value": "",
"type": "query",
"description": "Type of event"
},
{
"name": "pitchType",
"value": "",
"type": "query",
"description": "Classification of pitch (fastball, curveball, etc...)"
},
{
"name": "hitTrajectory",
"value": "",
"type": "query",
"description": "Trajectory of hit (line drive, fly ball, etc...)"
},
{
"name": "batSide",
"value": "",
"type": "query",
"description": "Bat side of hitter"
},
{
"name": "pitchHand",
"value": "",
"type": "query",
"description": "Handedness of pitcher"
},
{
"name": "venueId",
"value": "",
"type": "query",
"description": "All of the details of a venue"
},
{
"name": "metrics",
"value": "",
"type": "query",
"description": "Name of metric(s) for metric log stats. Available metrics in /api/v1/metrics"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "minValue",
"value": "",
"type": "query",
"description": "Minimum value to filter on"
},
{
"name": "maxValue",
"value": "",
"type": "query",
"description": "Maximum value to filter on"
},
{
"name": "percentile",
"value": "",
"type": "query",
"description": "Only return averages above this percentile. used for best effort plays"
},
{
"name": "minOccurrences",
"value": "",
"type": "query",
"description": "Minimum occurrences to filter upon"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "batterTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the batter's team"
},
{
"name": "pitcherTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the pitcher's team"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "debug",
"value": "",
"type": "query"
}
]
},
"docs": "View metric stats"
},
{
"info": {
"name": "Get leaders for a statistic",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/leaders",
"params": [
{
"name": "leaderCategories",
"value": "",
"type": "query"
},
{
"name": "leaderGameTypes",
"value": "",
"type": "query"
},
{
"name": "statGroup",
"value": "",
"type": "query"
},
{
"name": "season",
"value": "",
"type": "query"
},
{
"name": "expand",
"value": "",
"type": "query"
},
{
"name": "sportId",
"value": "",
"type": "query"
},
{
"name": "sportIds",
"value": "",
"type": "query"
},
{
"name": "stats",
"value": "",
"type": "query"
},
{
"name": "limit",
"value": "",
"type": "query"
},
{
"name": "offset",
"value": "",
"type": "query"
},
{
"name": "teamId",
"value": "",
"type": "query"
},
{
"name": "teamIds",
"value": "",
"type": "query"
},
{
"name": "leagueId",
"value": "",
"type": "query"
},
{
"name": "leagueIds",
"value": "",
"type": "query"
},
{
"name": "leagueListId",
"value": "",
"type": "query"
},
{
"name": "playerPool",
"value": "",
"type": "query"
},
{
"name": "statType",
"value": "",
"type": "query"
},
{
"name": "playerActive",
"value": "",
"type": "query"
},
{
"name": "position",
"value": "",
"type": "query"
},
{
"name": "sitCodes",
"value": "",
"type": "query"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query"
},
{
"name": "startDate",
"value": "",
"type": "query"
},
{
"name": "endDate",
"value": "",
"type": "query"
},
{
"name": "daysBack",
"value": "",
"type": "query"
},
{
"name": "gamesBack",
"value": "",
"type": "query"
},
{
"name": "groupBy",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "Get leaders for a statistic"
},
{
"info": {
"name": "View stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/grouped",
"params": [
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "personId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "metrics",
"value": "",
"type": "query",
"description": "Name of metric(s) for metric log stats. Available metrics in /api/v1/metrics"
},
{
"name": "gamePk",
"value": "",
"type": "query",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "batterTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the batter's team"
},
{
"name": "pitcherTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the pitcher's team"
},
{
"name": "batterId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "pitcherId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "combineSits",
"value": "",
"type": "query",
"description": "If true, gathers stats where all of the situational criteria are met. If false, returns stats where any of the situational criteria are met. Default: false"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "sortStat",
"value": "",
"type": "query",
"description": "Baseball stat to sort splits by."
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "playerPool",
"value": "",
"type": "query",
"description": "Return \"ALL\" or only \"QUALIFIED\" players based on plate appearances."
},
{
"name": "position",
"value": "",
"type": "query",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "daysBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' days (Starting from yesterday)."
},
{
"name": "gamesBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' games played."
},
{
"name": "excludeTradedPlayers",
"value": "",
"type": "query",
"description": "Excludes players who have since been traded from the input team"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "statFields",
"value": "",
"type": "query",
"description": "Baseball stat fields to populate"
},
{
"name": "sortField",
"value": "",
"type": "query",
"description": "Baseball statField to sort on. If no statField is given, sortField defaults to BASIC. If 1 statField is given, that is the default sortField."
}
]
},
"docs": "View stats"
},
{
"info": {
"name": "Get the probability of a hit for the given hit data",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/analytics/stolenBaseProbability",
"params": [
{
"name": "gamePk",
"value": "",
"type": "query"
},
{
"name": "timecode",
"value": "",
"type": "query"
}
]
},
"docs": "Get the probability of a hit for the given hit data"
},
{
"info": {
"name": "Get the spray chart info for the current batter",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/analytics/sprayChart",
"params": [
{
"name": "gamePk",
"value": "",
"type": "query"
},
{
"name": "timecode",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get the spray chart info for the current batter"
},
{
"info": {
"name": "Get the spray chart info for the current batter",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/analytics/outsAboveAverage",
"params": [
{
"name": "gamePk",
"value": "",
"type": "query"
},
{
"name": "timecode",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get the spray chart info for the current batter"
},
{
"info": {
"name": "Get the probability of a hit for the given hit data",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/stats/analytics/homeRunBallparkCount",
"params": [
{
"name": "sprayAngle",
"value": "",
"type": "query"
},
{
"name": "distance",
"value": "",
"type": "query"
},
{
"name": "isHomeRun",
"value": "",
"type": "query"
},
{
"name": "venueId",
"value": "",
"type": "query"
},
{
"name": "season",
"value": "",
"type": "query"
}
]
},
"docs": "Get the probability of a hit for the given hit data"
}
]
},
{
"info": {
"name": "Standings",
"type": "folder"
},
"items": [
{
"info": {
"name": "View standings for a league",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/standings/:standingsType",
"params": [
{
"name": "standingsType",
"value": "",
"type": "path",
"description": "Type of season. Available types in /api/v1/standingsTypes"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "standingsTypes",
"value": "",
"type": "query",
"description": "Type of season. Available types in /api/v1/standingsTypes"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "includeMLB",
"value": "",
"type": "query",
"description": "Determines whether to include major league teams when using the 'BY_ORGANIZATION' standings type"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull standings"
},
{
"info": {
"name": "View standings for a league",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/standings",
"params": [
{
"name": "standingsType",
"value": "",
"type": "path",
"description": "Type of season. Available types in /api/v1/standingsTypes"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "standingsTypes",
"value": "",
"type": "query",
"description": "Type of season. Available types in /api/v1/standingsTypes"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "includeMLB",
"value": "",
"type": "query",
"description": "Determines whether to include major league teams when using the 'BY_ORGANIZATION' standings type"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull standings"
}
]
},
{
"info": {
"name": "Sports",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get all players for a sport level",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/sports/:sportId/players",
"params": [
{
"name": "sportId",
"value": "",
"type": "path",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "hasStats",
"value": "",
"type": "query",
"description": "Returns sports that have individual player stats"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull all players for a given sport"
},
{
"info": {
"name": "Get ALL MLB ballot for sport",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/sports/:sportId/allSportBallot",
"params": [
{
"name": "sportId",
"value": "",
"type": "path",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "season"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "This endpoint allows you to get all players for MLB ballot"
},
{
"info": {
"name": "Get sports information",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/sports",
"params": [
{
"name": "sportId",
"value": "",
"type": "path",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "hasStats",
"value": "",
"type": "query",
"description": "Returns sports that have individual player stats"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching sports that are currently active (Y), inactive (N), pending (P), or all teams (B)"
}
]
},
"docs": "This endpoint allows you to pull sports"
},
{
"info": {
"name": "Get sports information",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/sports/:sportId",
"params": [
{
"name": "sportId",
"value": "",
"type": "path",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "hasStats",
"value": "",
"type": "query",
"description": "Returns sports that have individual player stats"
},
{
"name": "activeStatus",
"value": "",
"type": "query",
"description": "Flag for fetching sports that are currently active (Y), inactive (N), pending (P), or all teams (B)"
}
]
},
"docs": "This endpoint allows you to pull sports"
}
]
},
{
"info": {
"name": "Season",
"type": "folder"
},
"items": [
{
"info": {
"name": "View all seasons",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/seasons/all",
"params": [
{
"name": "divisionId",
"value": "",
"type": "query",
"description": "Unique Division Identifier"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "withGameTypeDates",
"value": "",
"type": "query",
"description": "Retrieve dates for each game type"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to view all seasons for a given Division, League or Sport. One of the following parameters must be present: `divisionId`, `leagueId` or `sportId`."
},
{
"info": {
"name": "View season info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/seasons",
"params": [
{
"name": "seasonId",
"value": "",
"type": "path",
"description": "Season of play"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "withGameTypeDates",
"value": "",
"type": "query",
"description": "Retrieve dates for each game type"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint returns season info for a specific sport. The `sportId` parameter is required."
},
{
"info": {
"name": "View season info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/seasons/:seasonId",
"params": [
{
"name": "seasonId",
"value": "",
"type": "path",
"description": "Season of play"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "withGameTypeDates",
"value": "",
"type": "query",
"description": "Retrieve dates for each game type"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint returns season info for a specific sport. The `sportId` parameter is required."
}
]
},
{
"info": {
"name": "Reviews",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get review info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/review",
"params": [
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get review info"
}
]
},
{
"info": {
"name": "Predictions",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get play-level predictions based on input scenarios",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/props/play/predictions",
"params": [
{
"name": "batterId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "pitcherId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "venueId",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "batSide",
"value": "",
"type": "query",
"description": "Bat side of hitter"
},
{
"name": "pitchHand",
"value": "",
"type": "query",
"description": "Handedness of pitcher"
},
{
"name": "batterPosition",
"value": "",
"type": "query",
"description": "Position abbreviation. Format: SS, P, 1B, etc"
},
{
"name": "pitcherPosition",
"value": "",
"type": "query",
"description": "Position abbreviation. Format: SS, P, 1B, etc"
}
]
},
"docs": "This endpoint allows you to get play-level predictions based on input scenarios"
},
{
"info": {
"name": "Get play-level predictions based on input scenarios",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/props/play/predictions/adjust",
"params": [
{
"name": "batterId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "pitcherId",
"value": "",
"type": "query",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "venueId",
"value": "",
"type": "query",
"description": "Unique Venue Identifier"
},
{
"name": "batSide",
"value": "",
"type": "query",
"description": "Bat side of hitter"
},
{
"name": "pitchHand",
"value": "",
"type": "query",
"description": "Handedness of pitcher"
},
{
"name": "batterPosition",
"value": "",
"type": "query",
"description": "Position abbreviation. Format: SS, P, 1B, etc"
},
{
"name": "pitcherPosition",
"value": "",
"type": "query",
"description": "Position abbreviation. Format: SS, P, 1B, etc"
},
{
"name": "count",
"value": "",
"type": "query",
"description": "Count for the at-bat (1-0, 2-2, etc.)"
}
]
},
"docs": "This endpoint allows you to get play-level predictions based on input scenarios"
}
]
},
{
"info": {
"name": "Person",
"type": "folder"
},
"items": [
{
"info": {
"name": "View a players stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/:personId/stats",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "opposingPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team"
},
{
"name": "metrics",
"value": "",
"type": "query",
"description": "Name of metric(s) for metric log stats. Available metrics in /api/v1/metrics"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "combineSits",
"value": "",
"type": "query",
"description": "If true, gathers stats where all of the situational criteria are met. If false, returns stats where any of the situational criteria are met. Default: false"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "daysBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' days (Starting from yesterday)."
},
{
"name": "gamesBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' games played."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "eventType",
"value": "",
"type": "query",
"description": "Type of event"
},
{
"name": "pitchType",
"value": "",
"type": "query",
"description": "Classification of pitch (fastball, curveball, etc...)"
},
{
"name": "hitTrajectory",
"value": "",
"type": "query",
"description": "Trajectory of hit (line drive, fly ball, etc...)"
},
{
"name": "batSide",
"value": "",
"type": "query",
"description": "Bat side of hitter"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "groupBy",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a players stats"
},
{
"info": {
"name": "View a players stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/:personId/stats/metrics",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "stats",
"value": "",
"type": "query",
"description": "Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "opposingTeamId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team. Must be used with Team ID"
},
{
"name": "opposingPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for the opposing team"
},
{
"name": "metrics",
"value": "",
"type": "query",
"description": "Name of metric(s) for metric log stats. Available metrics in /api/v1/metrics"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "sitCodes",
"value": "",
"type": "query",
"description": "Situation code for a given stat split."
},
{
"name": "combineSits",
"value": "",
"type": "query",
"description": "If true, gathers stats where all of the situational criteria are met. If false, returns stats where any of the situational criteria are met. Default: false"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "daysBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' days (Starting from yesterday)."
},
{
"name": "gamesBack",
"value": "",
"type": "query",
"description": "Returns results from the last 'X' games played."
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "eventType",
"value": "",
"type": "query",
"description": "Type of event"
},
{
"name": "pitchType",
"value": "",
"type": "query",
"description": "Classification of pitch (fastball, curveball, etc...)"
},
{
"name": "hitTrajectory",
"value": "",
"type": "query",
"description": "Trajectory of hit (line drive, fly ball, etc...)"
},
{
"name": "batSide",
"value": "",
"type": "query",
"description": "Bat side of hitter"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "groupBy",
"value": "",
"type": "query",
"description": "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a players stats"
},
{
"info": {
"name": "View a players stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/:personId/stats/game/:gamePk",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a players stats"
},
{
"info": {
"name": "View a players stats",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/:personId/stats/game/current",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a players stats"
},
{
"info": {
"name": "View a players awards",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/:personId/awards",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a players awards"
},
{
"info": {
"name": "View a person(s) biographical information",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/:personId",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "personIds",
"value": "",
"type": "query",
"description": "Comma delimited list of person ID. Format: 1234, 2345"
},
{
"name": "accent",
"value": "",
"type": "query",
"description": "Boolean value to specify wanting a person's name with accents or without"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull the information of players, coaches and umpires"
},
{
"info": {
"name": "View a person(s) biographical information",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people",
"params": [
{
"name": "personId",
"value": "",
"type": "path",
"description": "Unique Player Identifier. Format: 434538, 429665, etc"
},
{
"name": "personIds",
"value": "",
"type": "query",
"description": "Comma delimited list of person ID. Format: 1234, 2345"
},
{
"name": "accent",
"value": "",
"type": "query",
"description": "Boolean value to specify wanting a person's name with accents or without"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "group",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull the information of players, coaches and umpires"
},
{
"info": {
"name": "Search for a player by name",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/search",
"params": [
{
"name": "names",
"value": "",
"type": "query",
"description": "Name a player uses"
},
{
"name": "personIds",
"value": "",
"type": "query",
"description": "Comma delimited list of person ID. Format: 1234, 2345"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "active",
"value": "",
"type": "query",
"description": "Whether or not a player is active"
},
{
"name": "verified",
"value": "",
"type": "query",
"description": "Complete and confirmed all biographical data"
},
{
"name": "rookie",
"value": "",
"type": "query",
"description": "Whether or not a player is a rookie"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
}
]
},
"docs": "Search for a player by name"
},
{
"info": {
"name": "Get free agents",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/freeAgents",
"params": [
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "Get free agents"
},
{
"info": {
"name": "View a players change log",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/people/changes",
"params": [
{
"name": "updatedSince",
"value": "",
"type": "query",
"description": "Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a players change log"
}
]
},
{
"info": {
"name": "Milestones",
"type": "folder"
},
"items": [
{
"info": {
"name": "View pending and achieved milestones.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/milestones",
"params": [
{
"name": "orgType",
"value": "",
"type": "query",
"description": "Organization level. Format: T(Team), L(League), S(Sport)"
},
{
"name": "achievementStatuses",
"value": "",
"type": "query",
"description": "Comma delimited list of milestone achievement types"
},
{
"name": "milestoneTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of milestone types"
},
{
"name": "isLastAchievement",
"value": "",
"type": "query",
"description": "Filters out milestones that have already been surpassed."
},
{
"name": "milestoneStatistics",
"value": "",
"type": "query",
"description": "Comma delimited list of milestone statistics"
},
{
"name": "milestoneValues",
"value": "",
"type": "query",
"description": "Comma delimited list of milestone values"
},
{
"name": "playerIds",
"value": "",
"type": "query",
"description": "A unique identifier for players"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "statGroup",
"value": "",
"type": "query",
"description": "Category of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "seasons",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique venue identifiers"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View pending and achieved milestones."
},
{
"info": {
"name": "View available milestoneType options",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/milestoneLookups"
},
"docs": "View available milestoneType options"
}
]
},
{
"info": {
"name": "Job",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get jobs by type",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/jobs",
"params": [
{
"name": "jobType",
"value": "",
"type": "query",
"description": "Job Type Identifier (ie. UMPR, etc..)"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "Get jobs by type",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/jobs/umpires",
"params": [
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "Get umpires and associated game for umpireId",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/jobs/umpires/games/:umpireId",
"params": [
{
"name": "umpireId",
"value": "",
"type": "path",
"description": "A unique identifier for an umpire"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "Get jobs by type",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/jobs/officialScorers",
"params": [
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
},
{
"info": {
"name": "Get jobs by type",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/jobs/datacasters",
"params": [
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "date",
"value": "",
"type": "query",
"description": "Date of Game. Format: YYYY-MM-DD"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull teams"
}
]
},
{
"info": {
"name": "Homerun Derby",
"type": "folder"
},
"items": [
{
"info": {
"name": "View a home run derby object",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/homeRunDerby/:gamePk/pool",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull home run derby information"
},
{
"info": {
"name": "View a home run derby object",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/homeRunDerby/pool",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull home run derby information"
},
{
"info": {
"name": "View a home run derby object",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/homeRunDerby/:gamePk",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull home run derby information"
},
{
"info": {
"name": "View a home run derby object",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/homeRunDerby",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull home run derby information"
},
{
"info": {
"name": "View a home run derby object",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/homeRunDerby/:gamePk/bracket",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull home run derby information"
},
{
"info": {
"name": "View a home run derby object",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/homeRunDerby/bracket",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull home run derby information"
}
]
},
{
"info": {
"name": "High/Low",
"type": "folder"
},
"items": [
{
"info": {
"name": "View high/low stats by player or team",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/highLow/:highLowType",
"params": [
{
"name": "highLowType",
"value": "",
"type": "path",
"description": "Type of high/low stats ('player', 'team', 'game')"
},
{
"name": "statGroup",
"value": "",
"type": "query",
"description": "Comma delimited list of categories of statistic to return. Available types in /api/v1/statGroups"
},
{
"name": "sortStat",
"value": "",
"type": "query",
"description": "Comma delimited list of baseball stats to sort splits by."
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Comma delimited list of Seasons of play"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View high/low stats by player or team"
},
{
"info": {
"name": "View high/low stat types",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/highLow/types"
},
"docs": "View high/low stat types"
}
]
},
{
"info": {
"name": "Game Pace",
"type": "folder"
},
"items": [
{
"info": {
"name": "View time of game info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/gamePace",
"params": [
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "teamIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique Team identifiers"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "leagueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "leagueListId",
"value": "",
"type": "query",
"description": "Unique League List Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": "Start date for range of data (must be used with end date). Format: MM/DD/YYYY"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": "End date for range of data (must be used with start date). Format: MM/DD/YYYY"
},
{
"name": "venueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique venue identifiers"
},
{
"name": "excludeVenueIds",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique venue identifiers"
},
{
"name": "excludeGamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "orgType",
"value": "",
"type": "query",
"description": "Organization level. Format: T(Team), L(League), S(Sport)"
},
{
"name": "includeChildren",
"value": "",
"type": "query",
"description": "Determines weather to include results from an organization's children (ex. a sport would also include results for the teams and leagues)"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View time of game info"
}
]
},
{
"info": {
"name": "Game",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get game play By Play",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:game_pk/playByPlay",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "inclusiveTimecode",
"value": "",
"type": "query",
"description": "True to include plays that happen before or at the specified timecode"
}
]
},
"docs": "This endpoint allows you to pull the play by play of a game"
},
{
"info": {
"name": "Get game linescore",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:game_pk/linescore",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "inclusiveTimecode",
"value": "",
"type": "query",
"description": "True to include plays that happen before or at the specified timecode"
}
]
},
"docs": "This endpoint allows you to pull the linescore for a game"
},
{
"info": {
"name": "Get game color feed.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:game_pk/feed/color",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This API can return very large payloads. It is STRONGLY recommended that clients ask for diffs and use \"Accept-Encoding: gzip\" header."
},
{
"info": {
"name": "Retrieve all of the color timestamps for a game.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:game_pk/feed/color/timestamps",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
}
]
},
"docs": "This can be used for replaying games. Endpoint returns all of the timecodes that can be used with diffs for /v1/game/{game_pk}/feed/color"
},
{
"info": {
"name": "Retrieve all content for a game.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:game_pk/content",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path"
},
{
"name": "highlightLimit",
"value": "",
"type": "query",
"description": "Number of results to return"
}
]
},
"docs": "Retrieve all content for a game."
},
{
"info": {
"name": "Get game boxscore.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:game_pk/boxscore",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "inclusiveTimecode",
"value": "",
"type": "query",
"description": "True to include plays that happen before or at the specified timecode"
}
]
},
"docs": "This endpoint allows you to pull a boxscore"
},
{
"info": {
"name": "Get game info with metrics",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/withMetrics",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get game info with metrics"
},
{
"info": {
"name": "Get the win probability for this game",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/winProbability",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "inclusiveTimecode",
"value": "",
"type": "query",
"description": "True to include plays that happen before or at the specified timecode"
}
]
},
"docs": "Get the win probability for this game"
},
{
"info": {
"name": "Get the context metrics for this game based on its current state",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/contextMetrics",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get the context metrics for this game based on its current state"
},
{
"info": {
"name": "View a game change log",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/changes",
"params": [
{
"name": "updatedSince",
"value": "",
"type": "query",
"description": "Format: YYYY-MM-DDTHH:MM:SSZ"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "sportIds",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "gameType",
"value": "",
"type": "query",
"description": "Type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "gameTypes",
"value": "",
"type": "query",
"description": "Comma delimited list of type of Game. Available types in /api/v1/gameTypes"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "gamePks",
"value": "",
"type": "query",
"description": "Comma delimited list of unique primary keys"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View a game change log"
},
{
"info": {
"name": "Get live game status.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1.1/game/:game_pk/feed/live",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "timecode",
"value": "",
"type": "query",
"description": "Use this parameter to return a snapshot of the data at the specified time. Format: YYYYMMDD_HHMMSS"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "inclusiveTimecode",
"value": "",
"type": "query",
"description": "True to include plays that happen before or at the specified timecode"
}
]
},
"docs": "This API can return very large payloads. It is STRONGLY recommended that clients ask for diffs and use \"Accept-Encoding: gzip\" header."
},
{
"info": {
"name": "Retrieve all of the play timestamps for a game.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1.1/game/:game_pk/feed/live/timestamps",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
}
]
},
"docs": "This can be used for replaying games. Endpoint returns all of the timecodes that can be used with diffs for /v1/game/{game_pk}/feed/live"
},
{
"info": {
"name": "Get live game status.",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1.1/game/:game_pk/feed/live/diffPatch",
"params": [
{
"name": "game_pk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "startTimecode",
"value": "",
"type": "query",
"description": "Start time code will give you everything since that time. Format: MMDDYYYY_HHMMSS"
},
{
"name": "endTimecode",
"value": "",
"type": "query",
"description": "End time code will give you a snapshot at that specific time. Format: MMDDYYYY_HHMMSS"
}
]
},
"docs": "This endpoint allows comparison of game files and shows any differences/discrepancies between the two
Diff/Patch System: startTimecode and endTimecode can be used for getting diffs.
Expected usage:
1) Request full payload by not passing startTimecode or endTimecode. This will return the most recent game state.
2) Find the latest timecode in this response.
3) Wait X seconds
4) Use the timecode from 2 as the startTimecode. This will give you a diff of "
}
]
},
{
"info": {
"name": "Skeletal",
"type": "folder"
},
"items": [
{
"info": {
"name": "View Skeletal Data by playId and gameId",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:playId/analytics/skeletalData/files",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "playId",
"value": "",
"type": "path",
"description": "Unique play identifier"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull chunked skeletal tracking data by gameId and playId"
},
{
"info": {
"name": "View Skeletal Data by playId and gameId",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:playId/analytics/skeletalData/chunked",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "playId",
"value": "",
"type": "path",
"description": "Unique play identifier"
},
{
"name": "fileName",
"value": "",
"type": "query",
"description": "Skeletal chunked file name"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull chunked skeletal tracking data by gameId and playId"
}
]
},
{
"info": {
"name": "Biomechanics",
"type": "folder"
},
"items": [
{
"info": {
"name": "View Biomechanical data by playId and gameId filtered by player positionId",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/game/:gamePk/:playId/analytics/biomechanics/:positionId",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "playId",
"value": "",
"type": "path",
"description": "Unique play identifier"
},
{
"name": "positionId",
"value": "",
"type": "path",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull biomechanical tracking data by gameId and playId filtered by player positionId"
}
]
},
{
"info": {
"name": "Draft",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get the last drafted player and the next 5 teams up to pick",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/draft/:year/latest",
"params": [
{
"name": "year",
"value": "",
"type": "path",
"description": "Year the player was drafted. Format: 2000"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "Get the last drafted player and the next 5 teams up to pick"
},
{
"info": {
"name": "View MLB Draft Prospects",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/draft/prospects",
"params": [
{
"name": "year",
"value": "",
"type": "path",
"description": "Year the player was drafted. Format: 2000"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Sort the set of data by the specified field"
},
{
"name": "drafted",
"value": "",
"type": "query",
"description": "Whether or not the players been drafted"
},
{
"name": "round",
"value": "",
"type": "query",
"description": "Round in which a player was drafted"
},
{
"name": "name",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their name using using the specific character"
},
{
"name": "school",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their school using using the specific character"
},
{
"name": "position",
"value": "",
"type": "query",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "team",
"value": "",
"type": "query",
"description": "Unique Team Code. Format: tor, nya, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "state",
"value": "",
"type": "query",
"description": "State where the venue is located. Format: Ohio"
},
{
"name": "country",
"value": "",
"type": "query",
"description": "Filter players by their home country"
},
{
"name": "playerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "bisPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player in the EBIS system"
}
]
},
"docs": "View MLB Draft Prospects"
},
{
"info": {
"name": "View MLB Draft Prospects",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/draft/prospects/:year",
"params": [
{
"name": "year",
"value": "",
"type": "path",
"description": "Year the player was drafted. Format: 2000"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Sort the set of data by the specified field"
},
{
"name": "drafted",
"value": "",
"type": "query",
"description": "Whether or not the players been drafted"
},
{
"name": "round",
"value": "",
"type": "query",
"description": "Round in which a player was drafted"
},
{
"name": "name",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their name using using the specific character"
},
{
"name": "school",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their school using using the specific character"
},
{
"name": "position",
"value": "",
"type": "query",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "team",
"value": "",
"type": "query",
"description": "Unique Team Code. Format: tor, nya, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "state",
"value": "",
"type": "query",
"description": "State where the venue is located. Format: Ohio"
},
{
"name": "country",
"value": "",
"type": "query",
"description": "Filter players by their home country"
},
{
"name": "playerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "bisPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player in the EBIS system"
}
]
},
"docs": "View MLB Draft Prospects"
},
{
"info": {
"name": "View MLB Drafted Players",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/draft",
"params": [
{
"name": "year",
"value": "",
"type": "path",
"description": "Year the player was drafted. Format: 2000"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Sort the set of data by the specified field"
},
{
"name": "drafted",
"value": "",
"type": "query",
"description": "Whether or not the players been drafted"
},
{
"name": "round",
"value": "",
"type": "query",
"description": "Round in which a player was drafted"
},
{
"name": "name",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their name using using the specific character"
},
{
"name": "school",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their school using using the specific character"
},
{
"name": "position",
"value": "",
"type": "query",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "team",
"value": "",
"type": "query",
"description": "Unique Team Code. Format: tor, nya, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "state",
"value": "",
"type": "query",
"description": "State where the venue is located. Format: Ohio"
},
{
"name": "country",
"value": "",
"type": "query",
"description": "Filter players by their home country"
},
{
"name": "playerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "bisPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player in the EBIS system"
}
]
},
"docs": "View MLB Drafted Players"
},
{
"info": {
"name": "View MLB Drafted Players",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/draft/:year",
"params": [
{
"name": "year",
"value": "",
"type": "path",
"description": "Year the player was drafted. Format: 2000"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return"
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "The pointer to start for a return set; used for pagination"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
},
{
"name": "order",
"value": "",
"type": "query",
"description": "The order of sorting, ascending or descending"
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Sort the set of data by the specified field"
},
{
"name": "drafted",
"value": "",
"type": "query",
"description": "Whether or not the players been drafted"
},
{
"name": "round",
"value": "",
"type": "query",
"description": "Round in which a player was drafted"
},
{
"name": "name",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their name using using the specific character"
},
{
"name": "school",
"value": "",
"type": "query",
"description": "Filter players by the first letter of their school using using the specific character"
},
{
"name": "position",
"value": "",
"type": "query",
"description": "Position number. Format: 1, 2, 3, etc"
},
{
"name": "team",
"value": "",
"type": "query",
"description": "Unique Team Code. Format: tor, nya, etc"
},
{
"name": "teamId",
"value": "",
"type": "query",
"description": "Unique Team Identifier. Format: 141, 147, etc"
},
{
"name": "state",
"value": "",
"type": "query",
"description": "State where the venue is located. Format: Ohio"
},
{
"name": "country",
"value": "",
"type": "query",
"description": "Filter players by their home country"
},
{
"name": "playerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player"
},
{
"name": "bisPlayerId",
"value": "",
"type": "query",
"description": "A unique identifier for a player in the EBIS system"
}
]
},
"docs": "View MLB Drafted Players"
}
]
},
{
"info": {
"name": "Division",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get division information",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/divisions",
"params": [
{
"name": "divisionId",
"value": "",
"type": "path",
"description": "Unique Division Identifier"
},
{
"name": "includeInactive",
"value": "",
"type": "query",
"description": "Whether or not to include inactive"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull divisions"
},
{
"info": {
"name": "Get division information",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/divisions/:divisionId",
"params": [
{
"name": "divisionId",
"value": "",
"type": "path",
"description": "Unique Division Identifier"
},
{
"name": "includeInactive",
"value": "",
"type": "query",
"description": "Whether or not to include inactive"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Unique League Identifier"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull divisions"
}
]
},
{
"info": {
"name": "Conference",
"type": "folder"
},
"items": [
{
"info": {
"name": "View Conference Info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/conferences",
"params": [
{
"name": "conferenceId",
"value": "",
"type": "path"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "includeInactive",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View info for all PCL conferences or by conferenceId."
},
{
"info": {
"name": "View Conference Info",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/conferences/:conferenceId",
"params": [
{
"name": "conferenceId",
"value": "",
"type": "path"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "includeInactive",
"value": "",
"type": "query"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View info for all PCL conferences or by conferenceId."
}
]
},
{
"info": {
"name": "Broadcast",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get Broadcasts",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/broadcast",
"params": [
{
"name": "broadcasterIds",
"value": "",
"type": "query"
},
{
"name": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute",
"value": "",
"type": "query"
}
]
},
"docs": "Get Broadcasts"
}
]
},
{
"info": {
"name": "Bat Tracking",
"type": "folder"
},
"items": [
{
"info": {
"name": "View Bat Tracking Data by playId and gameId",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/batTracking/game/:gamePk/:playId",
"params": [
{
"name": "gamePk",
"value": "",
"type": "path",
"description": "Unique Primary Key Representing a Game"
},
{
"name": "playId",
"value": "",
"type": "path",
"description": "Unique play identifier"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "This endpoint allows you to pull bat tracking data by gameId and playId"
}
]
},
{
"info": {
"name": "Awards",
"type": "folder"
},
"items": [
{
"info": {
"name": "awardRecipients",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/awards/:awardId/recipients",
"params": [
{
"name": "awardId",
"value": "",
"type": "path",
"description": "Unique Award Identifier. Available awards in /api/v1/awards"
},
{
"name": "season",
"value": "",
"type": "query",
"description": "Season of play"
},
{
"name": "sportId",
"value": "",
"type": "query",
"description": "Top level organization of a sport"
},
{
"name": "leagueId",
"value": "",
"type": "query",
"description": "Comma delimited list of Unique league identifiers"
},
{
"name": "fields",
"value": "",
"type": "query"
}
]
},
"docs": "View recipients of an award"
},
{
"info": {
"name": "awards",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/awards",
"params": [
{
"name": "awardId",
"value": "",
"type": "path",
"description": "Unique Award Identifier. Available awards in /api/v1/awards"
},
{
"name": "orgId",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View awards info"
},
{
"info": {
"name": "awards_1",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://statsapi.mlb.com/api/v1/awards/:awardId",
"params": [
{
"name": "awardId",
"value": "",
"type": "path",
"description": "Unique Award Identifier. Available awards in /api/v1/awards"
},
{
"name": "orgId",
"value": "",
"type": "query",
"description": "Comma delimited list of top level organizations of a sport"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute"
}
]
},
"docs": "View awards info"
}
]
}
],
"bundled": true
}