7120 lines
203 KiB
YAML
7120 lines
203 KiB
YAML
openapi: 3.0.1
|
|
info:
|
|
description: Official API for Major League Baseball.
|
|
title: Stats API Documentation
|
|
version: 2.0.0
|
|
servers:
|
|
- url: /
|
|
tags:
|
|
- name: Reviews
|
|
- description: 'Operations pertaining to bat tracking data '
|
|
name: Bat Tracking
|
|
- name: Attendance
|
|
- description: Operations pertaining to leagues
|
|
name: League
|
|
- name: Predictions
|
|
- description: Operations pertaining to sports
|
|
name: Sports
|
|
- description: 'Operations pertaining to weather data '
|
|
name: Weather
|
|
- name: Misc
|
|
- description: Operations pertaining to high/low stats
|
|
name: High/Low
|
|
- description: Operations pertaining to jobs
|
|
name: Job
|
|
- description: Operations pertaining to divisions
|
|
name: Division
|
|
- description: Operations pertaining to games
|
|
name: Game
|
|
- description: Config elements
|
|
name: Misc
|
|
- description: Operations pertaining to home run derby
|
|
name: Homerun Derby
|
|
- description: Collapsed tags
|
|
name: Closed
|
|
x-tag-expanded: "false"
|
|
- description: Endpoints for stats streaks
|
|
name: Streaks
|
|
- description: Operations pertaining to stats
|
|
name: Stats
|
|
- description: Operations pertaining to venues
|
|
name: Venues
|
|
- description: Operations pertaining to players
|
|
name: Person
|
|
- description: Operations pertaining to awards
|
|
name: Awards
|
|
- name: Game Pace
|
|
- description: Operations pertaining to field tracking and analytics.
|
|
name: analytics
|
|
x-tag-expanded: "true"
|
|
- description: Operations pertaining to broadcasts
|
|
name: Broadcast
|
|
- description: Operations pertaining to schedules
|
|
name: Schedule
|
|
x-tag-expanded: "false"
|
|
- description: Operations pertaining to uniforms
|
|
name: Uniforms
|
|
- description: Operations pertaining to MLB BaseballDraft
|
|
name: Draft
|
|
- description: Operations pertaining to teams
|
|
name: Teams
|
|
- description: 'Operations pertaining to biomechanical data '
|
|
name: Biomechanics
|
|
- description: Operations pertaining to teams
|
|
name: Standings
|
|
- description: Operations pertaining to conferences
|
|
name: Conference
|
|
- description: Operations pertaining to transactions
|
|
name: Transactions
|
|
- description: 'Operations pertaining to skeletal data '
|
|
name: Skeletal
|
|
- description: Operations pertaining to seasons
|
|
name: Season
|
|
- description: Operations pertaining to milestones
|
|
name: Milestones
|
|
paths:
|
|
/api/v1/teams/{teamId}/alumni:
|
|
get:
|
|
operationId: alumni
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all team alumni
|
|
tags:
|
|
- Teams
|
|
post:
|
|
operationId: updateAlumni
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
tags:
|
|
- Teams
|
|
/api/v1/jobTypes:
|
|
get:
|
|
operationId: jobTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all job types
|
|
tags:
|
|
- Misc
|
|
post:
|
|
operationId: updateJobTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
tags:
|
|
- Misc
|
|
/api/v1/gameStatus:
|
|
get:
|
|
operationId: gameStatus
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all status types
|
|
tags:
|
|
- Misc
|
|
post:
|
|
operationId: updateGameStatuses
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Clear all status types
|
|
tags:
|
|
- Misc
|
|
/api/v1/game/{gamePk}/{guid}/contextMetricsAverages:
|
|
get:
|
|
description: "Returns a json file containing raw coordinate data and refined\
|
|
\ calculated metrics.<br/><br/>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."
|
|
operationId: contextMetricsWithAverages
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique identifier for a play within a game
|
|
in: path
|
|
name: guid
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get a json file containing raw coordinate data and refined calculated
|
|
metrics.
|
|
tags:
|
|
- analytics
|
|
post:
|
|
description: "Returns a json file containing raw coordinate data and refined\
|
|
\ calculated metrics.<br/><br/>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."
|
|
operationId: contextMetricsWithAveragesPost
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique identifier for a play within a game
|
|
in: path
|
|
name: guid
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get a json file containing raw coordinate data and refined calculated
|
|
metrics.
|
|
tags:
|
|
- analytics
|
|
/api/v1/windDirection:
|
|
get:
|
|
operationId: windDirection
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all wind direction options
|
|
tags:
|
|
- Misc
|
|
/api/v1/weatherTrajectoryConfidences:
|
|
get:
|
|
operationId: weatherTrajectoryConfidences
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all weather trajectories
|
|
tags:
|
|
- Misc
|
|
/api/v1/weather/venues/{venueId}/full:
|
|
get:
|
|
description: Returns a json file containing full weather for a specific venue.
|
|
operationId: weatherFull
|
|
parameters:
|
|
- description: Unique Venue Identifier
|
|
in: path
|
|
name: venueId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get full weather for a venue.
|
|
tags:
|
|
- Weather
|
|
/api/v1/weather/venues/{venueId}/basic:
|
|
get:
|
|
description: Returns a json file containing basic weather for a specific venue.
|
|
operationId: weatherBasic
|
|
parameters:
|
|
- description: Unique Venue Identifier
|
|
in: path
|
|
name: venueId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get basic weather for a venue.
|
|
tags:
|
|
- Weather
|
|
/api/v1/weather/game/{gamePk}/{playId}:
|
|
get:
|
|
description: Returns a json file containing weather for the current play.
|
|
operationId: weatherDataBasedOnPlay
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique identifier for a play within a game
|
|
in: path
|
|
name: playId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get the raw field weather data.
|
|
tags:
|
|
- Weather
|
|
/api/v1/weather/game/{gamePk}/forecast/{roofType}:
|
|
get:
|
|
description: Returns a json file containing the weather forecast for a specific
|
|
game.
|
|
operationId: weatherForecast
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Venue roof type
|
|
in: path
|
|
name: roofType
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get the weather forecast for a game.
|
|
tags:
|
|
- Weather
|
|
/api/v1/violationTypes:
|
|
get:
|
|
operationId: violationTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View available violationType options
|
|
tags:
|
|
- Misc
|
|
/api/v1/videoResolutionTypes:
|
|
get:
|
|
operationId: videoResolutionTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View video resolution options
|
|
tags:
|
|
- Misc
|
|
/api/v1/venues:
|
|
get:
|
|
description: This endpoint allows you to pull venues
|
|
operationId: venues
|
|
parameters:
|
|
- description: Unique Venue Identifier
|
|
in: path
|
|
name: venueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique venue identifiers
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Whether or not a player is active
|
|
in: query
|
|
name: active
|
|
schema: {}
|
|
- in: query
|
|
name: includeEvents
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View venue info
|
|
tags:
|
|
- Venues
|
|
/api/v1/venues/{venueId}:
|
|
get:
|
|
description: This endpoint allows you to pull venues
|
|
operationId: venues_1
|
|
parameters:
|
|
- description: Unique Venue Identifier
|
|
in: path
|
|
name: venueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique venue identifiers
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Whether or not a player is active
|
|
in: query
|
|
name: active
|
|
schema: {}
|
|
- in: query
|
|
name: includeEvents
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View venue info
|
|
tags:
|
|
- Venues
|
|
/api/v1/uniforms/team:
|
|
get:
|
|
description: This endpoint allows you to pull team uniform data for a season
|
|
operationId: uniformsByTeam
|
|
parameters:
|
|
- in: query
|
|
name: teamIds
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View Team Uniform info
|
|
tags:
|
|
- Uniforms
|
|
/api/v1/uniforms/game:
|
|
get:
|
|
description: This endpoint allows you to pull team uniform data for a game
|
|
operationId: uniformsByGame
|
|
parameters:
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View Game Uniform info
|
|
tags:
|
|
- Uniforms
|
|
/api/v1/transactions:
|
|
get:
|
|
description: This endpoint allows you to pull transactions.
|
|
operationId: transactions
|
|
parameters:
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerId
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- in: query
|
|
name: transactionIds
|
|
schema: {}
|
|
- in: query
|
|
name: transactionTypes
|
|
schema: {}
|
|
- in: query
|
|
name: divisionIds
|
|
schema: {}
|
|
- in: query
|
|
name: order
|
|
schema: {}
|
|
- in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View transaction info
|
|
tags:
|
|
- Transactions
|
|
/api/v1/transactionTypes:
|
|
get:
|
|
operationId: transactionTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all transaction types
|
|
tags:
|
|
- Misc
|
|
/api/v1/trackingVersions:
|
|
get:
|
|
operationId: trackingVersions
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all tracking versions
|
|
tags:
|
|
- Misc
|
|
/api/v1/trackingVendors:
|
|
get:
|
|
operationId: trackingVendors
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all tracking vendors
|
|
tags:
|
|
- Misc
|
|
/api/v1/trackingSystemOwners:
|
|
get:
|
|
operationId: trackingSystemOwners
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all tracking system owners
|
|
tags:
|
|
- Misc
|
|
/api/v1/trackingSoftwareVersions:
|
|
get:
|
|
operationId: trackingSoftwareVersions
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List the tracking software versions and notes
|
|
tags:
|
|
- Misc
|
|
/api/v1/teams/{teamId}/stats:
|
|
get:
|
|
operationId: stats
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
required: true
|
|
schema: {}
|
|
- description: Baseball stat to sort splits by.
|
|
in: query
|
|
name: sortStat
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
|
|
in: query
|
|
name: groupBy
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team
|
|
in: query
|
|
name: opposingPlayerId
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a teams stats
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/roster:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: roster
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Type of roster. Available types in /api/v1/rosterTypes
|
|
in: path
|
|
name: rosterType
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a teams roster
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/roster/{rosterType}:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: roster_1
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Type of roster. Available types in /api/v1/rosterTypes
|
|
in: path
|
|
name: rosterType
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a teams roster
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/personnel:
|
|
get:
|
|
operationId: personnel
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all coaches for a team
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/leaders:
|
|
get:
|
|
operationId: leaders
|
|
parameters:
|
|
- in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- in: query
|
|
name: leaderCategories
|
|
schema: {}
|
|
- in: query
|
|
name: season
|
|
schema: {}
|
|
- in: query
|
|
name: leaderGameTypes
|
|
schema: {}
|
|
- in: query
|
|
name: expand
|
|
schema: {}
|
|
- in: query
|
|
name: limit
|
|
schema: {}
|
|
- in: query
|
|
name: offset
|
|
schema: {}
|
|
- in: query
|
|
name: playerPool
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View team stat leaders
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/history:
|
|
get:
|
|
operationId: allTeams
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: "Start date for range of data (used with end date optionally).\
|
|
\ Example: '2018' or '2018.2'"
|
|
in: query
|
|
name: startSeason
|
|
schema: {}
|
|
- description: "End date for range of data (used with start date optionally).\
|
|
\ Format: '2018' or '2018.2'"
|
|
in: query
|
|
name: endSeason
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View historical records for a list of teams
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/history:
|
|
get:
|
|
operationId: allTeams_1
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: "Start date for range of data (used with end date optionally).\
|
|
\ Example: '2018' or '2018.2'"
|
|
in: query
|
|
name: startSeason
|
|
schema: {}
|
|
- description: "End date for range of data (used with start date optionally).\
|
|
\ Format: '2018' or '2018.2'"
|
|
in: query
|
|
name: endSeason
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View historical records for a list of teams
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/coaches:
|
|
get:
|
|
operationId: coaches
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all coaches for a team
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}/affiliates:
|
|
get:
|
|
operationId: affiliates
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View team and affiliate teams
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/affiliates:
|
|
get:
|
|
operationId: affiliates_1
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View team and affiliate teams
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/stats:
|
|
get:
|
|
operationId: stats_1
|
|
parameters:
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
required: true
|
|
schema: {}
|
|
- description: Baseball stat to sort splits by.
|
|
in: query
|
|
name: sortStat
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Returns results from the last 'X' days (Starting from yesterday).
|
|
in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- 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"
|
|
in: query
|
|
name: combineSits
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a teams stats
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/stats/leaders:
|
|
get:
|
|
operationId: leaders_1
|
|
parameters:
|
|
- description: TBD
|
|
in: query
|
|
name: leaderCategories
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
schema: {}
|
|
- in: query
|
|
name: statType
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: statGroup
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Returns results from the last 'X' days (Starting from yesterday).
|
|
in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View leaders for team stats
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: teams
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique Division Identifier
|
|
in: query
|
|
name: divisionId
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: "Flag for fetching teams that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- in: query
|
|
name: allStarStatuses
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View info for all teams
|
|
tags:
|
|
- Teams
|
|
/api/v1/teams/{teamId}:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: teams_1
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: path
|
|
name: teamId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique Division Identifier
|
|
in: query
|
|
name: divisionId
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: "Flag for fetching teams that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- in: query
|
|
name: allStarStatuses
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View info for all teams
|
|
tags:
|
|
- Teams
|
|
/api/v1/streaks:
|
|
get:
|
|
operationId: getStreaks
|
|
parameters:
|
|
- in: query
|
|
name: streakOrg
|
|
schema: {}
|
|
- in: query
|
|
name: streakStat
|
|
schema: {}
|
|
- in: query
|
|
name: streakSpan
|
|
schema: {}
|
|
- in: query
|
|
name: streakLevel
|
|
schema: {}
|
|
- in: query
|
|
name: streakThreshold
|
|
schema: {}
|
|
- in: query
|
|
name: inverse
|
|
schema: {}
|
|
- in: query
|
|
name: startersOnly
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: statGroup
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Whether or not a player is active
|
|
in: query
|
|
name: activeStreak
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerId
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View streaks
|
|
tags:
|
|
- Streaks
|
|
/api/v1/streaks/types:
|
|
get:
|
|
operationId: streakTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View streaks parameter options
|
|
tags:
|
|
- Streaks
|
|
/api/v1/stats:
|
|
get:
|
|
operationId: stats_2
|
|
parameters:
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
required: true
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: personId
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
required: true
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Name of metric(s) for metric log stats. Available metrics in
|
|
/api/v1/metrics
|
|
in: query
|
|
name: metrics
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
schema: {}
|
|
- description: A unique identifier for the batter's team
|
|
in: query
|
|
name: batterTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the pitcher's team
|
|
in: query
|
|
name: pitcherTeamId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: batterId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: pitcherId
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- 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"
|
|
in: query
|
|
name: combineSits
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Baseball stat to sort splits by.
|
|
in: query
|
|
name: sortStat
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Return "ALL" or only "QUALIFIED" players based on plate appearances.
|
|
in: query
|
|
name: playerPool
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Returns results from the last 'X' days (Starting from yesterday).
|
|
in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- description: Returns results from the last 'X' games played.
|
|
in: query
|
|
name: gamesBack
|
|
schema: {}
|
|
- description: Excludes players who have since been traded from the input team
|
|
in: query
|
|
name: excludeTradedPlayers
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View stats
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/search:
|
|
get:
|
|
operationId: beastStats
|
|
parameters:
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
schema: {}
|
|
- description: Comma delimited list of unique play identifiers
|
|
in: query
|
|
name: playIds
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: pitcherTeamIds
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: batterTeamIds
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: pitcherSportIds
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: batterSportIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: pitcherLeagueIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: batterLeagueIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique League Identifiers
|
|
in: query
|
|
name: divisionIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique League Identifiers
|
|
in: query
|
|
name: pitcherDivisionIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique League Identifiers
|
|
in: query
|
|
name: batterDivisionIds
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: pitchersOnTeamIds
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: battersOnTeamIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerIds
|
|
schema: {}
|
|
- description: Return "ALL" or only "QUALIFIED" players based on plate appearances.
|
|
in: query
|
|
name: playerPool
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: pitcherIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: batterIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: catcherIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: firstBasemanIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: secondBasemanIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: thirdBasemanIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: shortstopIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: leftFielderIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: centerFielderIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: rightFielderIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: runnerFirstIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: runnerSecondIds
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: runnerThirdIds
|
|
schema: {}
|
|
- description: Unique Venue Identifier
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: Handedness of pitcher
|
|
in: query
|
|
name: pitchHand
|
|
schema: {}
|
|
- description: Bat side of hitter
|
|
in: query
|
|
name: batSide
|
|
schema: {}
|
|
- description: "Classification of pitch (fastball, curveball, etc...)"
|
|
in: query
|
|
name: pitchTypes
|
|
schema: {}
|
|
- description: "Result of the pitch (ball, called strike, etc...)"
|
|
in: query
|
|
name: pitchCodes
|
|
schema: {}
|
|
- description: Type of event
|
|
in: query
|
|
name: eventTypes
|
|
schema: {}
|
|
- description: All of the details of a player's position
|
|
in: query
|
|
name: positions
|
|
schema: {}
|
|
- description: All of the details of a player's position
|
|
in: query
|
|
name: primaryPositions
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minPitchSpeed
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxPitchSpeed
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minSpinRate
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxSpinRate
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minExtension
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxExtension
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minExitVelocityAgainst
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxExitVelocityAgainst
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minLaunchAngleAgainst
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxLaunchAngleAgainst
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minExitVelocity
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxExitVelocity
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minLaunchAngle
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxLaunchAngle
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minHomeRunDistance
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxHomeRunDistance
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minHitDistance
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxHitDistance
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minHangTime
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxHangTime
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minHitProbability
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxHitProbability
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minCatchProbability
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxCatchProbability
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minAttackAngle
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxAttackAngle
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minBatSpeed
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxBatSpeed
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minHomeRunXBallparks
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxHomeRunXBallparks
|
|
schema: {}
|
|
- description: Whether or not a play resulted in a barreled ball
|
|
in: query
|
|
name: isBarrel
|
|
schema: {}
|
|
- description: "Trajectory of hit (line drive, fly ball, etc...)"
|
|
in: query
|
|
name: hitTrajectories
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
|
|
in: query
|
|
name: groupBy
|
|
schema: {}
|
|
- description: "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
|
|
in: query
|
|
name: compareOver
|
|
schema: {}
|
|
- description: Baseball stat to sort splits by.
|
|
in: query
|
|
name: sortStat
|
|
schema: {}
|
|
- description: "The prefix modifier for the sort stat. avg, min, max. I.E minExitVelocity,\
|
|
\ maxLaunchAngle, avgHitDistance"
|
|
in: query
|
|
name: sortModifier
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: sortOrder
|
|
schema: {}
|
|
- description: Only return averages above this percentile. used for best effort
|
|
plays
|
|
in: query
|
|
name: percentile
|
|
schema: {}
|
|
- description: Minimum occurrences to filter upon
|
|
in: query
|
|
name: minOccurrences
|
|
schema: {}
|
|
- description: Minimum occurrences to filter upon
|
|
in: query
|
|
name: minPlateAppearances
|
|
schema: {}
|
|
- description: Minimum occurrences to filter upon
|
|
in: query
|
|
name: minInnings
|
|
schema: {}
|
|
- description: Minimum occurrences to filter upon
|
|
in: query
|
|
name: qualifierRate
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- description: Columns to return totals
|
|
in: query
|
|
name: showTotals
|
|
schema: {}
|
|
- description: Show events with null metrics
|
|
in: query
|
|
name: includeNullMetrics
|
|
schema: {}
|
|
- description: Baseball stat fields to populate
|
|
in: query
|
|
name: statFields
|
|
schema: {}
|
|
- description: "The at bat number of a given game. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: atBatNumbers
|
|
schema: {}
|
|
- description: "The pitch number of a given game. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: pitchNumbers
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- in: query
|
|
name: debug
|
|
schema: {}
|
|
- description: Whether or not a player is active
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View stats from search
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/search/stats:
|
|
get:
|
|
operationId: statSearchStats
|
|
parameters:
|
|
- description: Categories of filters for stat search
|
|
in: query
|
|
name: filterLevel
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List stat search stats
|
|
tags:
|
|
- Misc
|
|
/api/v1/stats/search/params:
|
|
get:
|
|
operationId: statSearchParams
|
|
parameters:
|
|
- description: Categories of filters for stat search
|
|
in: query
|
|
name: filterLevel
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List stat search parameters
|
|
tags:
|
|
- Misc
|
|
/api/v1/stats/search/groupByTypes:
|
|
get:
|
|
operationId: statSearchGroupByTypes
|
|
parameters:
|
|
- description: Categories of filters for stat search
|
|
in: query
|
|
name: filterLevel
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List groupBy types
|
|
tags:
|
|
- Misc
|
|
/api/v1/stats/search/config:
|
|
get:
|
|
operationId: statSearchConfig
|
|
parameters:
|
|
- description: Categories of filters for stat search
|
|
in: query
|
|
name: filterLevel
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Stats Search Config Endpoint
|
|
tags:
|
|
- Misc
|
|
/api/v1/stats/metrics:
|
|
get:
|
|
operationId: metricStats
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: personId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: personIds
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: batterId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: pitcherId
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
required: true
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team
|
|
in: query
|
|
name: opposingPlayerId
|
|
schema: {}
|
|
- description: All of the details of a player's position
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: Type of event
|
|
in: query
|
|
name: eventType
|
|
schema: {}
|
|
- description: "Classification of pitch (fastball, curveball, etc...)"
|
|
in: query
|
|
name: pitchType
|
|
schema: {}
|
|
- description: "Trajectory of hit (line drive, fly ball, etc...)"
|
|
in: query
|
|
name: hitTrajectory
|
|
schema: {}
|
|
- description: Bat side of hitter
|
|
in: query
|
|
name: batSide
|
|
schema: {}
|
|
- description: Handedness of pitcher
|
|
in: query
|
|
name: pitchHand
|
|
schema: {}
|
|
- description: All of the details of a venue
|
|
in: query
|
|
name: venueId
|
|
schema: {}
|
|
- description: Name of metric(s) for metric log stats. Available metrics in
|
|
/api/v1/metrics
|
|
in: query
|
|
name: metrics
|
|
required: true
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
schema: {}
|
|
- description: Minimum value to filter on
|
|
in: query
|
|
name: minValue
|
|
schema: {}
|
|
- description: Maximum value to filter on
|
|
in: query
|
|
name: maxValue
|
|
schema: {}
|
|
- description: Only return averages above this percentile. used for best effort
|
|
plays
|
|
in: query
|
|
name: percentile
|
|
schema: {}
|
|
- description: Minimum occurrences to filter upon
|
|
in: query
|
|
name: minOccurrences
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: A unique identifier for the batter's team
|
|
in: query
|
|
name: batterTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the pitcher's team
|
|
in: query
|
|
name: pitcherTeamId
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- in: query
|
|
name: debug
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View metric stats
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/leaders:
|
|
get:
|
|
operationId: leaders_2
|
|
parameters:
|
|
- in: query
|
|
name: leaderCategories
|
|
schema: {}
|
|
- in: query
|
|
name: leaderGameTypes
|
|
schema: {}
|
|
- in: query
|
|
name: statGroup
|
|
schema: {}
|
|
- in: query
|
|
name: season
|
|
schema: {}
|
|
- in: query
|
|
name: expand
|
|
schema: {}
|
|
- in: query
|
|
name: sportId
|
|
schema: {}
|
|
- in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- in: query
|
|
name: stats
|
|
schema: {}
|
|
- in: query
|
|
name: limit
|
|
schema: {}
|
|
- in: query
|
|
name: offset
|
|
schema: {}
|
|
- in: query
|
|
name: teamId
|
|
schema: {}
|
|
- in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- in: query
|
|
name: playerPool
|
|
schema: {}
|
|
- in: query
|
|
name: statType
|
|
schema: {}
|
|
- in: query
|
|
name: playerActive
|
|
schema: {}
|
|
- in: query
|
|
name: position
|
|
schema: {}
|
|
- in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- in: query
|
|
name: startDate
|
|
schema: {}
|
|
- in: query
|
|
name: endDate
|
|
schema: {}
|
|
- in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- in: query
|
|
name: gamesBack
|
|
schema: {}
|
|
- in: query
|
|
name: groupBy
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get leaders for a statistic
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/grouped:
|
|
get:
|
|
operationId: groupedStats
|
|
parameters:
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
required: true
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: personId
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
required: true
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Name of metric(s) for metric log stats. Available metrics in
|
|
/api/v1/metrics
|
|
in: query
|
|
name: metrics
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
schema: {}
|
|
- description: A unique identifier for the batter's team
|
|
in: query
|
|
name: batterTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the pitcher's team
|
|
in: query
|
|
name: pitcherTeamId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: batterId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: pitcherId
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- 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"
|
|
in: query
|
|
name: combineSits
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Baseball stat to sort splits by.
|
|
in: query
|
|
name: sortStat
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Return "ALL" or only "QUALIFIED" players based on plate appearances.
|
|
in: query
|
|
name: playerPool
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Returns results from the last 'X' days (Starting from yesterday).
|
|
in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- description: Returns results from the last 'X' games played.
|
|
in: query
|
|
name: gamesBack
|
|
schema: {}
|
|
- description: Excludes players who have since been traded from the input team
|
|
in: query
|
|
name: excludeTradedPlayers
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: Baseball stat fields to populate
|
|
in: query
|
|
name: statFields
|
|
schema: {}
|
|
- 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."
|
|
in: query
|
|
name: sortField
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View grouped stats
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/analytics/stolenBaseProbability:
|
|
get:
|
|
operationId: getStolenBaseProbability
|
|
parameters:
|
|
- in: query
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- in: query
|
|
name: timecode
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get the probability of a hit for the given hit data
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/analytics/sprayChart:
|
|
get:
|
|
operationId: getSprayChart
|
|
parameters:
|
|
- in: query
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get the spray chart info for the current batter
|
|
tags:
|
|
- Stats
|
|
/api/v1/stats/analytics/outsAboveAverage:
|
|
get:
|
|
operationId: getOutsAboveAverage
|
|
parameters:
|
|
- in: query
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get outs above average for the current batter
|
|
tags:
|
|
- Stats
|
|
/api/v1/statcastPositionTypes:
|
|
get:
|
|
operationId: statcastPositionTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all statcast position types
|
|
tags:
|
|
- Misc
|
|
/api/v1/statTypes:
|
|
get:
|
|
operationId: statTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all stat types
|
|
tags:
|
|
- Misc
|
|
/api/v1/statGroups:
|
|
get:
|
|
operationId: statGroups
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all stat groups
|
|
tags:
|
|
- Misc
|
|
/api/v1/statFields:
|
|
get:
|
|
operationId: statFields
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all stat fields
|
|
tags:
|
|
- Misc
|
|
/api/v1/standingsTypes:
|
|
get:
|
|
operationId: standingsTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all standings types
|
|
tags:
|
|
- Misc
|
|
/api/v1/standings/{standingsType}:
|
|
get:
|
|
description: This endpoint allows you to pull standings
|
|
operationId: standings
|
|
parameters:
|
|
- description: Type of season. Available types in /api/v1/standingsTypes
|
|
in: path
|
|
name: standingsType
|
|
required: true
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Type of season. Available types in /api/v1/standingsTypes
|
|
in: query
|
|
name: standingsTypes
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Determines whether to include major league teams when using the
|
|
'BY_ORGANIZATION' standings type
|
|
in: query
|
|
name: includeMLB
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View standings for a league
|
|
tags:
|
|
- Standings
|
|
/api/v1/standings:
|
|
get:
|
|
description: This endpoint allows you to pull standings
|
|
operationId: standings_1
|
|
parameters:
|
|
- description: Type of season. Available types in /api/v1/standingsTypes
|
|
in: path
|
|
name: standingsType
|
|
required: true
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Type of season. Available types in /api/v1/standingsTypes
|
|
in: query
|
|
name: standingsTypes
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Determines whether to include major league teams when using the
|
|
'BY_ORGANIZATION' standings type
|
|
in: query
|
|
name: includeMLB
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View standings for a league
|
|
tags:
|
|
- Standings
|
|
/api/v1/sports/{sportId}/players:
|
|
get:
|
|
description: This endpoint allows you to pull all players for a given sport
|
|
operationId: sportPlayers
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: path
|
|
name: sportId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Returns sports that have individual player stats
|
|
in: query
|
|
name: hasStats
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get all players for a sport level
|
|
tags:
|
|
- Sports
|
|
/api/v1/sports/{sportId}/allSportBallot:
|
|
get:
|
|
description: This endpoint allows you to get all players for MLB ballot
|
|
operationId: allSportBallot
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: path
|
|
name: sportId
|
|
required: true
|
|
schema: {}
|
|
- description: season
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get ALL MLB ballot for sport
|
|
tags:
|
|
- Sports
|
|
/api/v1/sports:
|
|
get:
|
|
description: This endpoint allows you to pull sports
|
|
operationId: sports
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: path
|
|
name: sportId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Returns sports that have individual player stats
|
|
in: query
|
|
name: hasStats
|
|
schema: {}
|
|
- description: "Flag for fetching sports that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get sports information
|
|
tags:
|
|
- Sports
|
|
/api/v1/sports/{sportId}:
|
|
get:
|
|
description: This endpoint allows you to pull sports
|
|
operationId: sports_1
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: path
|
|
name: sportId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Returns sports that have individual player stats
|
|
in: query
|
|
name: hasStats
|
|
schema: {}
|
|
- description: "Flag for fetching sports that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get sports information
|
|
tags:
|
|
- Sports
|
|
/api/v1/sortModifiers:
|
|
get:
|
|
operationId: aggregateSortEnum
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all stat fields
|
|
tags:
|
|
- Misc
|
|
/api/v1/sky:
|
|
get:
|
|
operationId: sky
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all sky options
|
|
tags:
|
|
- Misc
|
|
/api/v1/situationCodes:
|
|
get:
|
|
operationId: sitCodes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: statGroup
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all situation codes
|
|
tags:
|
|
- Misc
|
|
/api/v1/seasons/all:
|
|
get:
|
|
description: "This endpoint allows you to view all seasons for a given Division,\
|
|
\ League or Sport"
|
|
operationId: allSeasons
|
|
parameters:
|
|
- description: Unique Division Identifier
|
|
in: query
|
|
name: divisionId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Retrieve dates for each game type
|
|
in: query
|
|
name: withGameTypeDates
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all seasons
|
|
tags:
|
|
- Season
|
|
/api/v1/seasons:
|
|
get:
|
|
description: This endpoint allows you to pull seasons
|
|
operationId: seasons
|
|
parameters:
|
|
- description: Season of play
|
|
in: path
|
|
name: seasonId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Retrieve dates for each game type
|
|
in: query
|
|
name: withGameTypeDates
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View season info
|
|
tags:
|
|
- Season
|
|
/api/v1/seasons/{seasonId}:
|
|
get:
|
|
description: This endpoint allows you to pull seasons
|
|
operationId: seasons_1
|
|
parameters:
|
|
- description: Season of play
|
|
in: path
|
|
name: seasonId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Retrieve dates for each game type
|
|
in: query
|
|
name: withGameTypeDates
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View season info
|
|
tags:
|
|
- Season
|
|
/api/v1/scheduleTypes:
|
|
get:
|
|
operationId: scheduleTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible schedule types
|
|
tags:
|
|
- Misc
|
|
/api/v1/scheduleEventTypes:
|
|
get:
|
|
operationId: scheduleEventTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all schedule event types
|
|
tags:
|
|
- Misc
|
|
/api/v1/schedule/trackingEvents:
|
|
get:
|
|
description: This endpoint allows you to pull schedules for tracking events
|
|
operationId: trackingEventsSchedule
|
|
parameters:
|
|
- description: Comma delimited list of type of calendar types
|
|
in: query
|
|
name: calendarTypes
|
|
schema: {}
|
|
- description: "Comma delimited list of type of events. <b>Note: Don't Use.\
|
|
\ This will be deprecated in favor of calendarTypes</b>"
|
|
in: query
|
|
name: eventTypes
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
schema: {}
|
|
- description: A unique identifier for non-game event
|
|
in: query
|
|
name: eventIds
|
|
schema: {}
|
|
- description: Unique Venue Identifier
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: A unique identifier for non-team event performers
|
|
in: query
|
|
name: performerIds
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- in: query
|
|
name: useLatestGames
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opponentId
|
|
schema: {}
|
|
- description: "Return public, non-public or all games. Format: Public Facing\
|
|
\ = 'Y', Non-Public Facing = 'N', All = 'A'"
|
|
in: query
|
|
name: publicFacing
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get tracking event schedules
|
|
tags:
|
|
- Schedule
|
|
/api/v1/schedule/postseason:
|
|
get:
|
|
description: This endpoint allows you to pull postseason schedules
|
|
operationId: postseasonSchedule
|
|
parameters:
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- in: query
|
|
name: seriesNumber
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- in: query
|
|
name: useLatestGames
|
|
schema: {}
|
|
- in: query
|
|
name: useFeaturedGame
|
|
schema: {}
|
|
- in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Return public, non-public or all games. Format: Public Facing\
|
|
\ = 'Y', Non-Public Facing = 'N', All = 'A'"
|
|
in: query
|
|
name: publicFacing
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get postseason schedule
|
|
tags:
|
|
- Schedule
|
|
/api/v1/schedule/postseason/tuneIn:
|
|
get:
|
|
description: This endpoint allows you to pull postseason schedules
|
|
operationId: tuneIn
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get postseason TuneIn schedules
|
|
tags:
|
|
- Schedule
|
|
/api/v1/schedule/postseason/series:
|
|
get:
|
|
description: This endpoint allows you to pull postseason schedules
|
|
operationId: postseasonScheduleSeries
|
|
parameters:
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- in: query
|
|
name: seriesNumber
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- in: query
|
|
name: useLatestGames
|
|
schema: {}
|
|
- in: query
|
|
name: useFeaturedGame
|
|
schema: {}
|
|
- in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get postseason series schedules
|
|
tags:
|
|
- Schedule
|
|
/api/v1/schedule/games/tied:
|
|
get:
|
|
description: This endpoint allows you to pull tie game schedules for the given
|
|
season
|
|
operationId: tieGames
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get tied game schedules
|
|
tags:
|
|
- Schedule
|
|
/api/v1/schedule:
|
|
get:
|
|
description: View schedule info. This endpoint allows you to pull schedules
|
|
operationId: schedule
|
|
parameters:
|
|
- description: Comma delimited list of type of calendar types
|
|
in: query
|
|
name: calendarTypes
|
|
schema: {}
|
|
- description: "Comma delimited list of type of events. <b>Note: Don't Use.\
|
|
\ This will be deprecated in favor of calendarTypes</b>"
|
|
in: query
|
|
name: eventTypes
|
|
schema: {}
|
|
- description: Comma delimited list of type of event types
|
|
in: query
|
|
name: scheduleEventTypes
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
schema: {}
|
|
- description: A unique identifier for non-game event
|
|
in: query
|
|
name: eventIds
|
|
schema: {}
|
|
- description: Unique Venue Identifier
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: A unique identifier for non-team event performers
|
|
in: query
|
|
name: performerIds
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- in: query
|
|
name: useLatestGames
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opponentId
|
|
schema: {}
|
|
- description: "Return public, non-public or all games. Format: Public Facing\
|
|
\ = 'Y', Non-Public Facing = 'N', All = 'A'"
|
|
in: query
|
|
name: publicFacing
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- in: query
|
|
name: usingPrivateEndpoint
|
|
required: true
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View schedule info based on scheduleType.
|
|
tags:
|
|
- Schedule
|
|
/api/v1/schedule/{scheduleType}:
|
|
get:
|
|
description: View schedule info. This endpoint allows you to pull schedules
|
|
operationId: schedule_1
|
|
parameters:
|
|
- description: Comma delimited list of type of calendar types
|
|
in: query
|
|
name: calendarTypes
|
|
schema: {}
|
|
- description: "Comma delimited list of type of events. <b>Note: Don't Use.\
|
|
\ This will be deprecated in favor of calendarTypes</b>"
|
|
in: query
|
|
name: eventTypes
|
|
schema: {}
|
|
- description: Comma delimited list of type of event types
|
|
in: query
|
|
name: scheduleEventTypes
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
schema: {}
|
|
- description: A unique identifier for non-game event
|
|
in: query
|
|
name: eventIds
|
|
schema: {}
|
|
- description: Unique Venue Identifier
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: A unique identifier for non-team event performers
|
|
in: query
|
|
name: performerIds
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- in: query
|
|
name: useLatestGames
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opponentId
|
|
schema: {}
|
|
- description: "Return public, non-public or all games. Format: Public Facing\
|
|
\ = 'Y', Non-Public Facing = 'N', All = 'A'"
|
|
in: query
|
|
name: publicFacing
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- in: query
|
|
name: usingPrivateEndpoint
|
|
required: true
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View schedule info based on scheduleType.
|
|
tags:
|
|
- Schedule
|
|
/api/v1/runnerDetailTypes:
|
|
get:
|
|
operationId: runnerDetailTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List runner detail types
|
|
tags:
|
|
- Misc
|
|
/api/v1/ruleSettings:
|
|
get:
|
|
operationId: ruleSettings
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: List all ruleSettings
|
|
tags:
|
|
- Misc
|
|
/api/v1/rosterTypes:
|
|
get:
|
|
operationId: rosterTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible roster types
|
|
tags:
|
|
- Misc
|
|
/api/v1/roofTypes:
|
|
get:
|
|
operationId: roofTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all roof types
|
|
tags:
|
|
- Misc
|
|
/api/v1/review:
|
|
get:
|
|
operationId: getReviewInfo
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: sportId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get review info
|
|
tags:
|
|
- Reviews
|
|
/api/v1/reviewReasons:
|
|
get:
|
|
operationId: reviewReasons
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all replay review reasons
|
|
tags:
|
|
- Misc
|
|
/api/v1/props/play/predictions:
|
|
get:
|
|
description: This endpoint allows you to get play-level predictions based on
|
|
input scenarios
|
|
operationId: getProps
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: batterId
|
|
schema: {}
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: query
|
|
name: pitcherId
|
|
schema: {}
|
|
- description: Unique Venue Identifier
|
|
in: query
|
|
name: venueId
|
|
schema: {}
|
|
- description: Bat side of hitter
|
|
in: query
|
|
name: batSide
|
|
schema: {}
|
|
- description: Handedness of pitcher
|
|
in: query
|
|
name: pitchHand
|
|
schema: {}
|
|
- description: "Position abbreviation. Format: SS, P, 1B, etc"
|
|
in: query
|
|
name: batterPosition
|
|
schema: {}
|
|
- description: "Position abbreviation. Format: SS, P, 1B, etc"
|
|
in: query
|
|
name: pitcherPosition
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get play-level predictions based on input scenarios
|
|
tags:
|
|
- Predictions
|
|
/api/v1/props/play/predictions/adjust:
|
|
get:
|
|
description: This endpoint allows you to get play-level predictions based on
|
|
input scenarios
|
|
operationId: getPropsAdjust
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get play-level predictions based on input scenarios
|
|
tags:
|
|
- Predictions
|
|
/api/v1/positions:
|
|
get:
|
|
operationId: positions
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible positions
|
|
tags:
|
|
- Misc
|
|
/api/v1/playerStatusCodes:
|
|
get:
|
|
operationId: playerStatusCodes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all player status codes
|
|
tags:
|
|
- Misc
|
|
/api/v1/platforms:
|
|
get:
|
|
operationId: platforms
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible platforms
|
|
tags:
|
|
- Misc
|
|
/api/v1/pitchTypes:
|
|
get:
|
|
operationId: pitchTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all pitch classification types
|
|
tags:
|
|
- Misc
|
|
/api/v1/pitchCodes:
|
|
get:
|
|
operationId: pitchCodes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all pitch codes
|
|
tags:
|
|
- Misc
|
|
/api/v1/performerTypes:
|
|
get:
|
|
operationId: performerTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible performer types
|
|
tags:
|
|
- Misc
|
|
/api/v1/people/{personId}/stats:
|
|
get:
|
|
operationId: stats_3
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: path
|
|
name: personId
|
|
required: true
|
|
schema: {}
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
required: true
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team
|
|
in: query
|
|
name: opposingPlayerId
|
|
schema: {}
|
|
- description: Name of metric(s) for metric log stats. Available metrics in
|
|
/api/v1/metrics
|
|
in: query
|
|
name: metrics
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- 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"
|
|
in: query
|
|
name: combineSits
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Returns results from the last 'X' days (Starting from yesterday).
|
|
in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- description: Returns results from the last 'X' games played.
|
|
in: query
|
|
name: gamesBack
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: Type of event
|
|
in: query
|
|
name: eventType
|
|
schema: {}
|
|
- description: "Classification of pitch (fastball, curveball, etc...)"
|
|
in: query
|
|
name: pitchType
|
|
schema: {}
|
|
- description: "Trajectory of hit (line drive, fly ball, etc...)"
|
|
in: query
|
|
name: hitTrajectory
|
|
schema: {}
|
|
- description: Bat side of hitter
|
|
in: query
|
|
name: batSide
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
|
|
in: query
|
|
name: groupBy
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a players stats
|
|
tags:
|
|
- Person
|
|
/api/v1/people/{personId}/stats/metrics:
|
|
get:
|
|
operationId: statsMetrics
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: path
|
|
name: personId
|
|
required: true
|
|
schema: {}
|
|
- description: "Type of statistics. Format: Individual, Team, Career, etc. Available\
|
|
\ types in /api/v1/statTypes"
|
|
in: query
|
|
name: stats
|
|
required: true
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team. Must be used with
|
|
Team ID
|
|
in: query
|
|
name: opposingTeamId
|
|
schema: {}
|
|
- description: A unique identifier for the opposing team
|
|
in: query
|
|
name: opposingPlayerId
|
|
schema: {}
|
|
- description: Name of metric(s) for metric log stats. Available metrics in
|
|
/api/v1/metrics
|
|
in: query
|
|
name: metrics
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Situation code for a given stat split.
|
|
in: query
|
|
name: sitCodes
|
|
schema: {}
|
|
- 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"
|
|
in: query
|
|
name: combineSits
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Returns results from the last 'X' days (Starting from yesterday).
|
|
in: query
|
|
name: daysBack
|
|
schema: {}
|
|
- description: Returns results from the last 'X' games played.
|
|
in: query
|
|
name: gamesBack
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: Type of event
|
|
in: query
|
|
name: eventType
|
|
schema: {}
|
|
- description: "Classification of pitch (fastball, curveball, etc...)"
|
|
in: query
|
|
name: pitchType
|
|
schema: {}
|
|
- description: "Trajectory of hit (line drive, fly ball, etc...)"
|
|
in: query
|
|
name: hitTrajectory
|
|
schema: {}
|
|
- description: Bat side of hitter
|
|
in: query
|
|
name: batSide
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP"
|
|
in: query
|
|
name: groupBy
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View a player's stat metrics
|
|
tags:
|
|
- Person
|
|
/api/v1/people/{personId}/stats/game/{gamePk}:
|
|
get:
|
|
operationId: playerGameStats
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: path
|
|
name: personId
|
|
required: true
|
|
schema: {}
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a player's game stats
|
|
tags:
|
|
- Person
|
|
/api/v1/people/{personId}/awards:
|
|
get:
|
|
operationId: award
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: path
|
|
name: personId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a player's awards
|
|
tags:
|
|
- Person
|
|
/api/v1/people/{personId}:
|
|
get:
|
|
description: This endpoint allows you to pull the information of players
|
|
operationId: person
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: path
|
|
name: personId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of person ID. Format: 1234, 2345"
|
|
in: query
|
|
name: personIds
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a player
|
|
tags:
|
|
- Person
|
|
/api/v1/people:
|
|
get:
|
|
description: This endpoint allows you to pull the information of players
|
|
operationId: person_1
|
|
parameters:
|
|
- description: "Unique Player Identifier. Format: 434538, 429665, etc"
|
|
in: path
|
|
name: personId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of person ID. Format: 1234, 2345"
|
|
in: query
|
|
name: personIds
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: group
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a player
|
|
tags:
|
|
- Person
|
|
/api/v1/people/search:
|
|
get:
|
|
operationId: search
|
|
parameters:
|
|
- description: Name a player uses
|
|
in: query
|
|
name: names
|
|
schema: {}
|
|
- description: "Comma delimited list of person ID. Format: 1234, 2345"
|
|
in: query
|
|
name: personIds
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Whether or not a player is active
|
|
in: query
|
|
name: active
|
|
schema: {}
|
|
- description: Complete and confirmed all biographical data
|
|
in: query
|
|
name: verified
|
|
schema: {}
|
|
- description: Whether or not a player is a rookie
|
|
in: query
|
|
name: rookie
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Search for a player by name
|
|
tags:
|
|
- Person
|
|
/api/v1/people/freeAgents:
|
|
get:
|
|
operationId: freeAgents
|
|
parameters:
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get free agents
|
|
tags:
|
|
- Person
|
|
/api/v1/people/changes:
|
|
get:
|
|
operationId: currentGameStats
|
|
parameters:
|
|
- description: "Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: updatedSince
|
|
required: true
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a player's change log
|
|
tags:
|
|
- Person
|
|
/api/v1/moundVisitTypes:
|
|
get:
|
|
operationId: moundVisitTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all mound visit types
|
|
tags:
|
|
- Misc
|
|
/api/v1/milestones:
|
|
get:
|
|
operationId: milestones
|
|
parameters:
|
|
- description: "Organization level. Format: T(Team), L(League), S(Sport)"
|
|
in: query
|
|
name: orgType
|
|
schema: {}
|
|
- description: Comma delimited list of milestone achievement types
|
|
in: query
|
|
name: achievementStatuses
|
|
schema: {}
|
|
- description: Comma delimited list of milestone types
|
|
in: query
|
|
name: milestoneTypes
|
|
schema: {}
|
|
- description: Filters out milestones that have already been surpassed.
|
|
in: query
|
|
name: isLastAchievement
|
|
schema: {}
|
|
- description: Comma delimited list of milestone statistics
|
|
in: query
|
|
name: milestoneStatistics
|
|
schema: {}
|
|
- description: Comma delimited list of milestone values
|
|
in: query
|
|
name: milestoneValues
|
|
schema: {}
|
|
- description: A unique identifier for players
|
|
in: query
|
|
name: playerIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Category of statistic to return. Available types in /api/v1/statGroups
|
|
in: query
|
|
name: statGroup
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: Comma delimited list of Unique venue identifiers
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "True to show play first milestones, like first HR, first Save,\
|
|
\ etc"
|
|
in: query
|
|
name: showFirsts
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View pending and achieved milestones.
|
|
tags:
|
|
- Milestones
|
|
/api/v1/milestoneTypes:
|
|
get:
|
|
operationId: milestoneTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View available milestoneType options
|
|
tags:
|
|
- Milestones
|
|
/api/v1/milestoneStatistics:
|
|
get:
|
|
operationId: milestoneStatistics
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View available milestone statistics options
|
|
tags:
|
|
- Milestones
|
|
/api/v1/milestoneLookups:
|
|
get:
|
|
operationId: milestoneLookups
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View available milestoneLookup options
|
|
tags:
|
|
- Milestones
|
|
/api/v1/milestoneDurations:
|
|
get:
|
|
operationId: milestoneDurations
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View available milestoneDurations options
|
|
tags:
|
|
- Milestones
|
|
/api/v1/metrics:
|
|
get:
|
|
operationId: metrics
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible metrics
|
|
tags:
|
|
- Misc
|
|
/api/v1/mediaState:
|
|
get:
|
|
operationId: mediaStateTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View media state options
|
|
tags:
|
|
- Misc
|
|
/api/v1/lookup/values/all:
|
|
get:
|
|
operationId: getLookupValues
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all lookup values
|
|
tags:
|
|
- Misc
|
|
/api/v1/logicalEvents:
|
|
get:
|
|
operationId: logicalEvents
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all logical event types
|
|
tags:
|
|
- Misc
|
|
/api/v1/leagueLeaderTypes:
|
|
get:
|
|
operationId: leagueLeaderTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible player league leader types
|
|
tags:
|
|
- Misc
|
|
/api/v1/league/{leagueId}/allStarWriteIns:
|
|
get:
|
|
operationId: allStarWriteIns
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all star write ins info
|
|
tags:
|
|
- League
|
|
/api/v1/leagues/{leagueId}/allStarWriteIns:
|
|
get:
|
|
operationId: allStarWriteIns_1
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all star write ins info
|
|
tags:
|
|
- League
|
|
/api/v1/league/{leagueId}/allStarFinalVote:
|
|
get:
|
|
operationId: allStarFinalVote
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all star final vote info
|
|
tags:
|
|
- League
|
|
/api/v1/leagues/{leagueId}/allStarFinalVote:
|
|
get:
|
|
operationId: allStarFinalVote_1
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View all star final vote info
|
|
tags:
|
|
- League
|
|
/api/v1/league/allStarBallot:
|
|
get:
|
|
operationId: allStarBallot
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View al star ballot info
|
|
tags:
|
|
- League
|
|
/api/v1/league/{leagueId}/allStarBallot:
|
|
get:
|
|
operationId: allStarBallot_1
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View al star ballot info
|
|
tags:
|
|
- League
|
|
/api/v1/leagues/allStarBallot:
|
|
get:
|
|
operationId: allStarBallot_2
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View al star ballot info
|
|
tags:
|
|
- League
|
|
/api/v1/leagues/{leagueId}/allStarBallot:
|
|
get:
|
|
operationId: allStarBallot_3
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View al star ballot info
|
|
tags:
|
|
- League
|
|
/api/v1/league:
|
|
get:
|
|
operationId: league
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Flag for fetching leagues that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View league info
|
|
tags:
|
|
- League
|
|
/api/v1/league/{leagueId}:
|
|
get:
|
|
operationId: league_1
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Flag for fetching leagues that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View league info
|
|
tags:
|
|
- League
|
|
/api/v1/leagues:
|
|
get:
|
|
operationId: league_2
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Flag for fetching leagues that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View league info
|
|
tags:
|
|
- League
|
|
/api/v1/leagues/{leagueId}:
|
|
get:
|
|
operationId: league_3
|
|
parameters:
|
|
- description: Unique League Identifier
|
|
in: path
|
|
name: leagueId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: seasons
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Flag for fetching leagues that are currently active (Y), inactive\
|
|
\ (N), pending (P), or all teams (B)"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View league info
|
|
tags:
|
|
- League
|
|
/api/v1/languages:
|
|
get:
|
|
operationId: languages
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all support languages
|
|
tags:
|
|
- Misc
|
|
/api/v1/jobs:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: getJobsByType
|
|
parameters:
|
|
- description: "Job Type Identifier (ie. UMPR, etc..)"
|
|
in: query
|
|
name: jobType
|
|
required: true
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get jobs by type
|
|
tags:
|
|
- Job
|
|
/api/v1/jobs/umpires:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: umpires
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get umpires
|
|
tags:
|
|
- Job
|
|
/api/v1/jobs/umpires/games/{umpireId}:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: umpireSchedule
|
|
parameters:
|
|
- description: A unique identifier for an umpire
|
|
in: path
|
|
name: umpireId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get umpires and associated game for umpireId
|
|
tags:
|
|
- Job
|
|
/api/v1/jobs/officialScorers:
|
|
get:
|
|
description: This endpoint allows you to pull teams
|
|
operationId: officialScorers
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get official scorers
|
|
tags:
|
|
- Job
|
|
/api/v1/jobs/datacasters:
|
|
get:
|
|
description: Get datacaster jobs
|
|
operationId: datacasters
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get datacaster jobs
|
|
tags:
|
|
- Job
|
|
/api/v1/homeRunDerby/{gamePk}/pool:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyPool
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View home run derby pool
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby/pool:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyPool_1
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View home run derby pool
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby/{gamePk}/mixed:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyMixedMode
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View home run derby mixed mode (Bracket/Pool combo)
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby/mixed:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyMixedMode_1
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View home run derby mixed mode (Bracket/Pool combo)
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby/{gamePk}:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyBracket
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a home run derby object
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyBracket_1
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a home run derby object
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby/{gamePk}/bracket:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyBracket_2
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a home run derby object
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/homeRunDerby/bracket:
|
|
get:
|
|
description: This endpoint allows you to pull home run derby information
|
|
operationId: homeRunDerbyBracket_3
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a home run derby object
|
|
tags:
|
|
- Homerun Derby
|
|
/api/v1/hitTrajectories:
|
|
get:
|
|
operationId: hitTrajectories
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all hit trajectories
|
|
tags:
|
|
- Misc
|
|
/api/v1/highLow/{highLowType}:
|
|
get:
|
|
operationId: highLow
|
|
parameters:
|
|
- description: "Type of high/low stats ('player', 'team', 'game')"
|
|
in: path
|
|
name: highLowType
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of categories of statistic to return. Available
|
|
types in /api/v1/statGroups
|
|
in: query
|
|
name: statGroup
|
|
schema: {}
|
|
- description: Comma delimited list of baseball stats to sort splits by.
|
|
in: query
|
|
name: sortStat
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View high/low stats by player or team
|
|
tags:
|
|
- High/Low
|
|
/api/v1/highLow/types:
|
|
get:
|
|
operationId: highLowStats
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View high/low stat types
|
|
tags:
|
|
- High/Low
|
|
/api/v1/groupByTypes:
|
|
get:
|
|
operationId: groupByTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List groupBy types
|
|
tags:
|
|
- Misc
|
|
/api/v1/gamedayTypes:
|
|
get:
|
|
operationId: gamedayTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all gameday types
|
|
tags:
|
|
- Misc
|
|
/api/v1/gameTypes:
|
|
get:
|
|
operationId: gameTypes
|
|
parameters:
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all game types
|
|
tags:
|
|
- Misc
|
|
/api/v1/gamePace:
|
|
get:
|
|
operationId: gamePace
|
|
parameters:
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique Team identifiers
|
|
in: query
|
|
name: teamIds
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueIds
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: Comma delimited list of Unique venue identifiers
|
|
in: query
|
|
name: venueIds
|
|
schema: {}
|
|
- description: Comma delimited list of Unique venue identifiers
|
|
in: query
|
|
name: excludeVenueIds
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: excludeGamePks
|
|
schema: {}
|
|
- description: "Organization level. Format: T(Team), L(League), S(Sport)"
|
|
in: query
|
|
name: orgType
|
|
schema: {}
|
|
- description: Determines weather to include results from an organization's
|
|
children (ex. a sport would also include results for the teams and leagues)
|
|
in: query
|
|
name: includeChildren
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View time of game info
|
|
tags:
|
|
- Game Pace
|
|
/api/v1/game/{game_pk}/playByPlay:
|
|
get:
|
|
description: This endpoint allows you to pull the play by play of a game
|
|
operationId: playByPlay
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: True to include plays that happen before or at the specified
|
|
timecode
|
|
in: query
|
|
name: inclusiveTimecode
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get game play By Play
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{game_pk}/linescore:
|
|
get:
|
|
description: This endpoint allows you to pull the linescore for a game
|
|
operationId: linescore
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: True to include plays that happen before or at the specified
|
|
timecode
|
|
in: query
|
|
name: inclusiveTimecode
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get game linescore
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{game_pk}/feed/color:
|
|
get:
|
|
description: "This API can return very large payloads. It is STRONGLY recommended\
|
|
\ that clients ask for diffs and use \"Accept-Encoding: gzip\" header."
|
|
operationId: colorFeed
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get game color feed.
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{game_pk}/feed/color/timestamps:
|
|
get:
|
|
description: "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"
|
|
operationId: colorTimestamps
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Retrieve all of the color timestamps for a game.
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{game_pk}/content:
|
|
get:
|
|
operationId: content
|
|
parameters:
|
|
- in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: highlightLimit
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Retrieve all content for a game.
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{game_pk}/boxscore:
|
|
get:
|
|
description: This endpoint allows you to pull a boxscore
|
|
operationId: boxscore
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: True to include plays that happen before or at the specified
|
|
timecode
|
|
in: query
|
|
name: inclusiveTimecode
|
|
schema: {}
|
|
- description: Number of top player game scores to show. Default is 3.
|
|
in: query
|
|
name: numPlayers
|
|
schema: {}
|
|
- description: "If set to false, will show all players tied for the last spot\
|
|
\ in the game scores list."
|
|
in: query
|
|
name: noTies
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get game boxscore.
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{gamePk}/{playId}/analytics/skeletalData/files:
|
|
get:
|
|
description: This endpoint allows you to pull chunked skeletal tracking data
|
|
by gameId and playId
|
|
operationId: skeletalDataFileNames
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique play identifier
|
|
in: path
|
|
name: playId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View Skeletal Data by playId and gameId files
|
|
tags:
|
|
- Skeletal
|
|
/api/v1/game/{gamePk}/{playId}/analytics/skeletalData/chunked:
|
|
get:
|
|
description: This endpoint allows you to pull chunked skeletal tracking data
|
|
by gameId and playId
|
|
operationId: skeletalChunked
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique play identifier
|
|
in: path
|
|
name: playId
|
|
required: true
|
|
schema: {}
|
|
- description: Skeletal chunked file name
|
|
in: query
|
|
name: fileName
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View Skeletal Data by playId and gameId chunked
|
|
tags:
|
|
- Skeletal
|
|
/api/v1/game/{gamePk}/{playId}/analytics/biomechanics/{positionId}:
|
|
get:
|
|
description: This endpoint allows you to pull biomechanical tracking data by
|
|
gameId and playId filtered by player positionId
|
|
operationId: biomechanical
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique play identifier
|
|
in: path
|
|
name: playId
|
|
required: true
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: path
|
|
name: positionId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View Biomechanical data by playId and gameId filtered by player positionId
|
|
tags:
|
|
- Biomechanics
|
|
/api/v1/game/{gamePk}/{guid}/homeRunBallparks:
|
|
get:
|
|
description: "Returns a json file containing raw coordinate data and refined\
|
|
\ calculated metrics.<br/><br/>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."
|
|
operationId: homeRunBallparks
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique identifier for a play within a game
|
|
in: path
|
|
name: guid
|
|
required: true
|
|
schema: {}
|
|
- in: query
|
|
name: isHomeRunParks
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get if the play is a home run is each park for a specific play.
|
|
tags:
|
|
- analytics
|
|
/api/v1/game/{gamePk}/{guid}/contextMetrics:
|
|
get:
|
|
description: "Returns a json file containing raw coordinate data and refined\
|
|
\ calculated metrics.<br/><br/>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."
|
|
operationId: contextMetrics
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique identifier for a play within a game
|
|
in: path
|
|
name: guid
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get context metrics for a specific gamePk.
|
|
tags:
|
|
- analytics
|
|
/api/v1/game/{gamePk}/{guid}/analytics:
|
|
get:
|
|
description: "Returns a json file containing raw coordinate data and refined\
|
|
\ calculated metrics.<br/><br/>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."
|
|
operationId: parsedJsonFormattedAnalytics
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique identifier for a play within a game
|
|
in: path
|
|
name: guid
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get Statcast data for a specific play.
|
|
tags:
|
|
- analytics
|
|
/api/v1/game/{gamePk}/withMetrics:
|
|
get:
|
|
operationId: getGameWithMetrics
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: True to include plays that happen before or at the specified
|
|
timecode
|
|
in: query
|
|
name: inclusiveTimecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get game info with metrics
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{gamePk}/winProbability:
|
|
get:
|
|
operationId: getWinProbability
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: True to include plays that happen before or at the specified
|
|
timecode
|
|
in: query
|
|
name: inclusiveTimecode
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get the win probability for this game
|
|
tags:
|
|
- Game
|
|
/api/v1/game/{gamePk}/guids:
|
|
get:
|
|
operationId: gameGuids
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "Statcast game mode. Format: 0 = Batting Practive, 1 = Warmup\
|
|
\ 2 = Live"
|
|
in: query
|
|
name: gameModeId
|
|
schema: {}
|
|
- description: If there was a pitch
|
|
in: query
|
|
name: isPitch
|
|
schema: {}
|
|
- description: If there was a hit ball tracked
|
|
in: query
|
|
name: isHit
|
|
schema: {}
|
|
- description: If there was a pickoff
|
|
in: query
|
|
name: isPickoff
|
|
schema: {}
|
|
- description: True if updated by an auditor
|
|
in: query
|
|
name: hasUpdates
|
|
schema: {}
|
|
- description: "Returns all data that was created after the specified timestamp.\
|
|
\ Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: since
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: updatedSince
|
|
schema: {}
|
|
- description: "Returns all data that was created after the specified timestamp.\
|
|
\ Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastPlayTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastMetricsUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastAuditUpdatedTime
|
|
schema: {}
|
|
- description: The last time SportyBot video was updated
|
|
in: query
|
|
name: lastVideoUpdatedTime
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: 'Get the GUIDs (plays) for a specific game. '
|
|
tags:
|
|
- analytics
|
|
/api/v1/game/{gamePk}/contextMetrics:
|
|
get:
|
|
operationId: getGameContextMetrics
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get the context metrics for this game based on its current state
|
|
tags:
|
|
- Game
|
|
/api/v1/game/lastPitch:
|
|
get:
|
|
operationId: gameLastPitch
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: query
|
|
name: gamePks
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get the last pitch for a list of games
|
|
tags:
|
|
- analytics
|
|
/api/v1/game/changes:
|
|
get:
|
|
operationId: currentGameStats_1
|
|
parameters:
|
|
- description: "Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: updatedSince
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: sportIds
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Comma delimited list of type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameTypes
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Comma delimited list of unique primary keys
|
|
in: query
|
|
name: gamePks
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View a game change log
|
|
tags:
|
|
- Game
|
|
/api/v1/freeGameTypes:
|
|
get:
|
|
operationId: freeGameTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View free game types
|
|
tags:
|
|
- Misc
|
|
/api/v1/fielderDetailTypes:
|
|
get:
|
|
operationId: fielderDetailTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List fielder detail types
|
|
tags:
|
|
- Misc
|
|
/api/v1/eventTypes:
|
|
get:
|
|
operationId: eventTypes
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all event types
|
|
tags:
|
|
- Misc
|
|
/api/v1/eventStatus:
|
|
get:
|
|
operationId: eventStatus
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all possible event status types
|
|
tags:
|
|
- Misc
|
|
/api/v1/draft/{year}/latest:
|
|
get:
|
|
operationId: latestDraftPicks
|
|
parameters:
|
|
- description: "Year the player was drafted. Format: 2000"
|
|
in: path
|
|
name: year
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get the last drafted player and the next 5 teams up to pick
|
|
tags:
|
|
- Draft
|
|
/api/v1/draft/prospects:
|
|
get:
|
|
operationId: draftProspects
|
|
parameters:
|
|
- description: "Year the player was drafted. Format: 2000"
|
|
in: path
|
|
name: year
|
|
required: true
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Sort the set of data by the specified field
|
|
in: query
|
|
name: sortBy
|
|
schema: {}
|
|
- description: Whether or not the players been drafted
|
|
in: query
|
|
name: drafted
|
|
schema: {}
|
|
- description: Round in which a player was drafted
|
|
in: query
|
|
name: round
|
|
schema: {}
|
|
- description: Filter players by the first letter of their name using using
|
|
the specific character
|
|
in: query
|
|
name: name
|
|
schema: {}
|
|
- description: Filter players by the first letter of their school using using
|
|
the specific character
|
|
in: query
|
|
name: school
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: "Unique Team Code. Format: tor, nya, etc"
|
|
in: query
|
|
name: team
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: "State where the venue is located. Format: Ohio"
|
|
in: query
|
|
name: state
|
|
schema: {}
|
|
- description: Filter players by their home country
|
|
in: query
|
|
name: country
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerId
|
|
schema: {}
|
|
- description: A unique identifier for a player in the EBIS system
|
|
in: query
|
|
name: bisPlayerId
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View MLB Draft Prospects
|
|
tags:
|
|
- Draft
|
|
/api/v1/draft/prospects/{year}:
|
|
get:
|
|
operationId: draftProspects_1
|
|
parameters:
|
|
- description: "Year the player was drafted. Format: 2000"
|
|
in: path
|
|
name: year
|
|
required: true
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Sort the set of data by the specified field
|
|
in: query
|
|
name: sortBy
|
|
schema: {}
|
|
- description: Whether or not the players been drafted
|
|
in: query
|
|
name: drafted
|
|
schema: {}
|
|
- description: Round in which a player was drafted
|
|
in: query
|
|
name: round
|
|
schema: {}
|
|
- description: Filter players by the first letter of their name using using
|
|
the specific character
|
|
in: query
|
|
name: name
|
|
schema: {}
|
|
- description: Filter players by the first letter of their school using using
|
|
the specific character
|
|
in: query
|
|
name: school
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: "Unique Team Code. Format: tor, nya, etc"
|
|
in: query
|
|
name: team
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: "State where the venue is located. Format: Ohio"
|
|
in: query
|
|
name: state
|
|
schema: {}
|
|
- description: Filter players by their home country
|
|
in: query
|
|
name: country
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerId
|
|
schema: {}
|
|
- description: A unique identifier for a player in the EBIS system
|
|
in: query
|
|
name: bisPlayerId
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View MLB Draft Prospects
|
|
tags:
|
|
- Draft
|
|
/api/v1/draft:
|
|
get:
|
|
operationId: draftPicks
|
|
parameters:
|
|
- description: "Year the player was drafted. Format: 2000"
|
|
in: path
|
|
name: year
|
|
required: true
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Sort the set of data by the specified field
|
|
in: query
|
|
name: sortBy
|
|
schema: {}
|
|
- description: Whether or not the players been drafted
|
|
in: query
|
|
name: drafted
|
|
schema: {}
|
|
- description: Round in which a player was drafted
|
|
in: query
|
|
name: round
|
|
schema: {}
|
|
- description: Filter players by the first letter of their name using using
|
|
the specific character
|
|
in: query
|
|
name: name
|
|
schema: {}
|
|
- description: Filter players by the first letter of their school using using
|
|
the specific character
|
|
in: query
|
|
name: school
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: "Unique Team Code. Format: tor, nya, etc"
|
|
in: query
|
|
name: team
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: "State where the venue is located. Format: Ohio"
|
|
in: query
|
|
name: state
|
|
schema: {}
|
|
- description: Filter players by their home country
|
|
in: query
|
|
name: country
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerId
|
|
schema: {}
|
|
- description: A unique identifier for a player in the EBIS system
|
|
in: query
|
|
name: bisPlayerId
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View MLB Drafted Players
|
|
tags:
|
|
- Draft
|
|
/api/v1/draft/{year}:
|
|
get:
|
|
operationId: draftPicks_1
|
|
parameters:
|
|
- description: "Year the player was drafted. Format: 2000"
|
|
in: path
|
|
name: year
|
|
required: true
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "The order of sorting, ascending or descending"
|
|
in: query
|
|
name: order
|
|
schema: {}
|
|
- description: Sort the set of data by the specified field
|
|
in: query
|
|
name: sortBy
|
|
schema: {}
|
|
- description: Whether or not the players been drafted
|
|
in: query
|
|
name: drafted
|
|
schema: {}
|
|
- description: Round in which a player was drafted
|
|
in: query
|
|
name: round
|
|
schema: {}
|
|
- description: Filter players by the first letter of their name using using
|
|
the specific character
|
|
in: query
|
|
name: name
|
|
schema: {}
|
|
- description: Filter players by the first letter of their school using using
|
|
the specific character
|
|
in: query
|
|
name: school
|
|
schema: {}
|
|
- description: "Position number. Format: 1, 2, 3, etc"
|
|
in: query
|
|
name: position
|
|
schema: {}
|
|
- description: "Unique Team Code. Format: tor, nya, etc"
|
|
in: query
|
|
name: team
|
|
schema: {}
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: "State where the venue is located. Format: Ohio"
|
|
in: query
|
|
name: state
|
|
schema: {}
|
|
- description: Filter players by their home country
|
|
in: query
|
|
name: country
|
|
schema: {}
|
|
- description: A unique identifier for a player
|
|
in: query
|
|
name: playerId
|
|
schema: {}
|
|
- description: A unique identifier for a player in the EBIS system
|
|
in: query
|
|
name: bisPlayerId
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View MLB Drafted Players
|
|
tags:
|
|
- Draft
|
|
/api/v1/divisions:
|
|
get:
|
|
description: This endpoint allows you to pull divisions
|
|
operationId: divisions
|
|
parameters:
|
|
- description: Unique Division Identifier
|
|
in: path
|
|
name: divisionId
|
|
required: true
|
|
schema: {}
|
|
- description: Whether or not to include inactive
|
|
in: query
|
|
name: includeInactive
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get division information
|
|
tags:
|
|
- Division
|
|
/api/v1/divisions/{divisionId}:
|
|
get:
|
|
description: This endpoint allows you to pull divisions
|
|
operationId: divisions_1
|
|
parameters:
|
|
- description: Unique Division Identifier
|
|
in: path
|
|
name: divisionId
|
|
required: true
|
|
schema: {}
|
|
- description: Whether or not to include inactive
|
|
in: query
|
|
name: includeInactive
|
|
schema: {}
|
|
- description: Unique League Identifier
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get division information
|
|
tags:
|
|
- Division
|
|
/api/v1/conferences:
|
|
get:
|
|
operationId: conferences
|
|
parameters:
|
|
- in: path
|
|
name: conferenceId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- in: query
|
|
name: includeInactive
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View conference info
|
|
tags:
|
|
- Conference
|
|
/api/v1/conferences/{conferenceId}:
|
|
get:
|
|
operationId: conferences_1
|
|
parameters:
|
|
- in: path
|
|
name: conferenceId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- in: query
|
|
name: includeInactive
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View conference info
|
|
tags:
|
|
- Conference
|
|
/api/v1/coachingVideoTypes:
|
|
get:
|
|
operationId: coachingVideoTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all coaching video types
|
|
tags:
|
|
- Misc
|
|
/api/v1/broadcasters:
|
|
get:
|
|
operationId: getAllBroadcasters
|
|
parameters:
|
|
- description: "Current status of the broadcaster. Format: Active = y, inactive\
|
|
\ = n, both = b"
|
|
in: query
|
|
name: activeStatus
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get All Active Broadcasters
|
|
tags:
|
|
- Broadcast
|
|
/api/v1/broadcast:
|
|
get:
|
|
operationId: getBroadcasts
|
|
parameters:
|
|
- description: All of the broadcast details
|
|
in: query
|
|
name: broadcasterIds
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get Broadcasters
|
|
tags:
|
|
- Broadcast
|
|
/api/v1/broadcastAvailability:
|
|
get:
|
|
operationId: broadcastAvailabilityTypes
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View broadcast availability options
|
|
tags:
|
|
- Misc
|
|
/api/v1/batTracking/game/{gamePk}/{playId}:
|
|
get:
|
|
description: This endpoint allows you to pull bat tracking data by gameId and
|
|
playId
|
|
operationId: batTracking
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: gamePk
|
|
required: true
|
|
schema: {}
|
|
- description: Unique play identifier
|
|
in: path
|
|
name: playId
|
|
required: true
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: View Bat Tracking Data by playId and gameId
|
|
tags:
|
|
- Bat Tracking
|
|
/api/v1/baseballStats:
|
|
get:
|
|
operationId: baseballStats
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: List all baseball stats
|
|
tags:
|
|
- Misc
|
|
/api/v1/awards/{awardId}/recipients:
|
|
get:
|
|
operationId: awardRecipients
|
|
parameters:
|
|
- description: Unique Award Identifier. Available awards in /api/v1/awards
|
|
in: path
|
|
name: awardId
|
|
required: true
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View recipients of an award
|
|
tags:
|
|
- Awards
|
|
/api/v1/awards:
|
|
get:
|
|
operationId: awards
|
|
parameters:
|
|
- description: Unique Award Identifier. Available awards in /api/v1/awards
|
|
in: path
|
|
name: awardId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: orgId
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View awards info
|
|
tags:
|
|
- Awards
|
|
/api/v1/awards/{awardId}:
|
|
get:
|
|
operationId: awards_1
|
|
parameters:
|
|
- description: Unique Award Identifier. Available awards in /api/v1/awards
|
|
in: path
|
|
name: awardId
|
|
required: true
|
|
schema: {}
|
|
- description: Comma delimited list of top level organizations of a sport
|
|
in: query
|
|
name: orgId
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View awards info
|
|
tags:
|
|
- Awards
|
|
/api/v1/attendance:
|
|
get:
|
|
operationId: getTeamAttendance
|
|
parameters:
|
|
- description: "Unique Team Identifier. Format: 141, 147, etc"
|
|
in: query
|
|
name: teamId
|
|
schema: {}
|
|
- description: Comma delimited list of Unique league identifiers
|
|
in: query
|
|
name: leagueId
|
|
schema: {}
|
|
- description: Comma delimited list of Seasons of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Unique League List Identifier
|
|
in: query
|
|
name: leagueListId
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: date
|
|
schema: {}
|
|
- description: "Start date for range of data (must be used with end date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: startDate
|
|
schema: {}
|
|
- description: "End date for range of data (must be used with start date). Format:\
|
|
\ MM/DD/YYYY"
|
|
in: query
|
|
name: endDate
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get team attendance
|
|
tags:
|
|
- Attendance
|
|
/api/v1/analytics/guids:
|
|
get:
|
|
operationId: gameGuidsFromPostgresRange
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "Statcast game mode. Format: 0 = Batting Practive, 1 = Warmup\
|
|
\ 2 = Live"
|
|
in: query
|
|
name: gameModeId
|
|
schema: {}
|
|
- description: If there was a pitch
|
|
in: query
|
|
name: isPitch
|
|
schema: {}
|
|
- description: If there was a hit ball tracked
|
|
in: query
|
|
name: isHit
|
|
schema: {}
|
|
- description: If there was a pickoff
|
|
in: query
|
|
name: isPickoff
|
|
schema: {}
|
|
- description: If non statcast games need to be included
|
|
in: query
|
|
name: isNonStatcast
|
|
schema: {}
|
|
- description: "Indicates the level of Gameday (tracking, play-by-play, linescore,\
|
|
\ etc...)"
|
|
in: query
|
|
name: gamedayType
|
|
schema: {}
|
|
- description: True if updated by an auditor
|
|
in: query
|
|
name: hasUpdates
|
|
schema: {}
|
|
- description: "Returns all data that was created after the specified timestamp.\
|
|
\ Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastPlayTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastMetricsUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastAuditUpdatedTime
|
|
schema: {}
|
|
- description: The last time SportyBot video was updated
|
|
in: query
|
|
name: lastVideoUpdatedTime
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: gameDate
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Owner of the tracking system
|
|
in: query
|
|
name: trackingSystemOwner
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Sort the set of data by the specified field
|
|
in: query
|
|
name: sortBy
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: 'Get the GUIDs (plays) for a specific game. '
|
|
tags:
|
|
- analytics
|
|
/api/v1/analytics/game:
|
|
get:
|
|
operationId: gameGuidsFromPostgresRangeByGame
|
|
parameters:
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: "Statcast game mode. Format: 0 = Batting Practive, 1 = Warmup\
|
|
\ 2 = Live"
|
|
in: query
|
|
name: gameModeId
|
|
schema: {}
|
|
- description: If there was a pitch
|
|
in: query
|
|
name: isPitch
|
|
schema: {}
|
|
- description: If there was a hit ball tracked
|
|
in: query
|
|
name: isHit
|
|
schema: {}
|
|
- description: If there was a pickoff
|
|
in: query
|
|
name: isPickoff
|
|
schema: {}
|
|
- description: If non statcast games need to be included
|
|
in: query
|
|
name: isNonStatcast
|
|
schema: {}
|
|
- description: "Indicates the level of Gameday (tracking, play-by-play, linescore,\
|
|
\ etc...)"
|
|
in: query
|
|
name: gamedayType
|
|
schema: {}
|
|
- description: True if updated by an auditor
|
|
in: query
|
|
name: hasUpdates
|
|
schema: {}
|
|
- description: "Returns all data that was created after the specified timestamp.\
|
|
\ Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastPlayTime
|
|
schema: {}
|
|
- description: The last time SportyBot video was updated
|
|
in: query
|
|
name: lastVideoUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastMetricsUpdatedTime
|
|
schema: {}
|
|
- description: "Return data updated since a specified date. Format: YYYY-MM-DDTHH:MM:SSZ"
|
|
in: query
|
|
name: lastAuditUpdatedTime
|
|
schema: {}
|
|
- description: "Date of Game. Format: YYYY-MM-DD"
|
|
in: query
|
|
name: gameDate
|
|
schema: {}
|
|
- description: Top level organization of a sport
|
|
in: query
|
|
name: sportId
|
|
schema: {}
|
|
- description: Type of Game. Available types in /api/v1/gameTypes
|
|
in: query
|
|
name: gameType
|
|
schema: {}
|
|
- description: Season of play
|
|
in: query
|
|
name: season
|
|
schema: {}
|
|
- description: Owner of the tracking system
|
|
in: query
|
|
name: trackingSystemOwner
|
|
schema: {}
|
|
- description: Sort the set of data by the specified field
|
|
in: query
|
|
name: sortBy
|
|
schema: {}
|
|
- description: Number of results to return
|
|
in: query
|
|
name: limit
|
|
schema: {}
|
|
- description: The pointer to start for a return set; used for pagination
|
|
in: query
|
|
name: offset
|
|
schema: {}
|
|
- description: Comma delimited list of type of event types
|
|
in: query
|
|
name: scheduleEventTypes
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
security:
|
|
- basicAuth: []
|
|
- bearerAuth: []
|
|
summary: Get all games by updated date.
|
|
tags:
|
|
- analytics
|
|
/api/v1/achievementStatuses:
|
|
get:
|
|
operationId: achievementStatuses
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: View available achievementStatus options
|
|
tags:
|
|
- Milestones
|
|
/api/v1.1/game/{game_pk}/feed/live:
|
|
get:
|
|
description: "This API can return very large payloads. It is STRONGLY recommended\
|
|
\ that clients ask for diffs and use \"Accept-Encoding: gzip\" header."
|
|
operationId: liveGameV1
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: "Use this parameter to return a snapshot of the data at the specified\
|
|
\ time. Format: YYYYMMDD_HHMMSS"
|
|
in: query
|
|
name: timecode
|
|
schema: {}
|
|
- description: "Comma delimited list of specific fields to be returned. Format:\
|
|
\ topLevelNode, childNode, attribute"
|
|
in: query
|
|
name: fields
|
|
schema: {}
|
|
- description: True to include plays that happen before or at the specified
|
|
timecode
|
|
in: query
|
|
name: inclusiveTimecode
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get live game status.
|
|
tags:
|
|
- Game
|
|
/api/v1.1/game/{game_pk}/feed/live/timestamps:
|
|
get:
|
|
description: "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"
|
|
operationId: liveTimestampv11
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Retrieve all of the play timestamps for a game.
|
|
tags:
|
|
- Game
|
|
/api/v1.1/game/{game_pk}/feed/live/diffPatch:
|
|
get:
|
|
description: "This endpoint allows comparison of game files and shows any differences/discrepancies\
|
|
\ between the two<br/><br/><b>Diff/Patch System:</b> startTimecode and endTimecode\
|
|
\ can be used for getting diffs.<br/>Expected usage: <br/> 1) Request full\
|
|
\ payload by not passing startTimecode or endTimecode. This will return the\
|
|
\ most recent game state.<br/> 2) Find the latest timecode in this response.\
|
|
\ <br/> 3) Wait X seconds<br/> 4) Use the timecode from 2 as the startTimecode.\
|
|
\ This will give you a diff of everything that has happened since startTimecode.\
|
|
\ <br/> 5) If no data is returned, wait X seconds and do the same request.\
|
|
\ <br/> 6) If data is returned, get a new timeStamp from the response, and\
|
|
\ use that for the next call as startTimecode."
|
|
operationId: liveGameDiffPatchV1
|
|
parameters:
|
|
- description: Unique Primary Key Representing a Game
|
|
in: path
|
|
name: game_pk
|
|
required: true
|
|
schema: {}
|
|
- description: "Start time code will give you everything since that time. Format:\
|
|
\ MMDDYYYY_HHMMSS"
|
|
in: query
|
|
name: startTimecode
|
|
schema: {}
|
|
- description: "End time code will give you a snapshot at that specific time.\
|
|
\ Format: MMDDYYYY_HHMMSS"
|
|
in: query
|
|
name: endTimecode
|
|
schema: {}
|
|
- description: Boolean value to specify wanting a person's name with accents
|
|
or without
|
|
in: query
|
|
name: accent
|
|
schema: {}
|
|
responses:
|
|
"200":
|
|
content: {}
|
|
description: OK
|
|
summary: Get live game status diffPatch.
|
|
tags:
|
|
- Game
|
|
components:
|
|
schemas: {}
|
|
x-original-swagger-version: 3.0.1
|