I/O Docs

The API calls below can be used to test the Input and Output of our API endpoints. You'll need an API key and an assigned secret to access the live data and so if you haven't contacted us yet, now is the time! Our sales staff would be happy to set you up with trial access so you can begin to evaluate the product.

After you've been given an API key and secret, enter it below and "Get" the method you'd like to try out. Fill in the parameters with what you'd like to try, or use the built in defaults, and click "Try It!" to execute the call. The JSON or XML response will be populated in the Response Body, the Response Body will provide you with any relevant codes, and the Request Header URI will show you how the call would be made within your application.

Please note:

This web application will sometimes take a long time to display the results when you click "Try it!" than it does to actually receive the data. You can confirm how long it takes for STATS to process the request by looking at the timeTaken node in the results body.

For the IO endpoints below, the parameters you fill are ARE case sensitive. For example, "/v1/decode/networktypes/" will return "596 Service Not Found"; it must be "/v1/decode/networkTypes".

Also, endpoints almost always require a final "/". You will receive "596 Service Not Found" when it is missing. An exception to this is for optional methods, such as eventId or teamId.

Select an Interactive Documentation
All Sports (Shared Resources)
Australian Football
Baseball - MLB
Baseball - Other
Basketball - CBK
Basketball - NBA
Basketball - Other
Basketball - WCBK
Basketball - WNBA
Boxing
Football - CFB
Football - NFL
Football - Other
Golf
Hockey - NHL
Hockey - Other
Horse Racing
MMA - UFC
Motor
Rugby
Soccer
Sumo
Tennis
Volleyball

Resources shared across sports and leagues.

Australian Football

MLB - Major League Baseball

Baseball - Other

CBK - College Basketball

NBA - National Basketball Association

Basketball - Other

WCBK - Women's College Basketball

WNBA - Women National Basketball Association

Boxing

CFB - College Football

NFL - National Football League

Football - Other

Golf

NHL - National Hockey League

Hockey - Other

horseRacing

UFC - Ultimate Fighting Championship

Motor

Rugby

Soccer

Sumo

Tennis

Volleyball

OAuth 2.0 Flow:

Existing Client Credentials:

API Key:

App/Key: Manually provide key information

Shared Secret:

Client ID:

Client Secret:

Client ID:

Client Secret:

Username:

Password:

Client ID:

Client Secret:

Authorization Code:

Access Token:

Username:

Password:

Username:

Binary Security Token:

Username:

Password:

Shared Resources

List Methods

Expand Methods

GET All Headlines editorial/stories/headlines/list/

Parameter	Value	Type	Description
languageId		string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept		string	Preferred response type. Default - json

GET All Headlines - Top editorial/top/stories/headlines

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET All Stories - Recent editorial/stories/list/

Parameter	Value	Type	Description
languageId		string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept		string	Preferred response type. Default - json

GET Countries decode/countries/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Currencies decode/currencies/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Event Data Confirmed stats/:sportName/:leagueAbbrev/eventDataConfirmed/

Parameter	Type	Description
:sportName	string	Sport Name - enter sport name in all lower case. See /stats/sports/ endpoint for full list. For example: baseball, football, soccer.
:leagueAbbrev	string	League URI path - Enter league URI path in all lower case. See /stats/[sport]/leagues endpoint for full list. For example: mlb, nfl, epl.
confirmedSince	string	How far back to check for confirmed data. The time zone is UTC. This can be a full date, like 2023-05-01. Or it can be a full date and time, like 2023-05-01T09:00:00. Those are the only two formatting options. Default - last 24 hours
accept	string	Preferred response type. Default - json

GET Date Data Updated stats/:sportName/:leagueAbbrev/dateDataUpdated/

Parameter	Type	Description
:sportName	string	Sport Name - enter sport name in all lower case. See /stats/sports/ endpoint for full list. For example: baseball, football, soccer, etc.
:leagueAbbrev	string	League URI path - Enter league URI path in all lower case. See /stats/[sport]/leagues endpoint for full list. For example: mlb, nfl, epl, etc.
accept	string	Preferred response type. Default - json

GET Languages decode/languages/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Network Types decode/networkTypes/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Name Displays decode/nameDisplays/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Season Structure decode/:sportName/:leagueAbbrev/seasonStructure/

Parameter	Type	Description
:sportName	string	Sport Name - enter sport name in all lower case. See /stats/sports/ endpoint for full list. For example: baseball, football, soccer, etc.
:leagueAbbrev	string	League URI path - Enter league URI path in all lower case. See /stats/[sport]/leagues endpoint for full list. For example: mlb, nfl, epl, etc.
season	string	Season. Default - current season if allSeasons parameter is not utilized
allSeasons	string	When true, returns all seasons. When false, or not utilized, defers to season parameter.
accept	string	Preferred response type. Default - json

GET All Sports Major Events stats/majorEvents

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Major Events Decode decode/majorEvents/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Major Event Types Decode decode/majorEventTypes/

Parameter	Value	Type	Description
accept		string	Preferred response type. Default - json

GET Schedule Delete - Current Season Only stats/:sportName/:leagueAbbrev/eventsDeleted/

Parameter	Type	Description
:sportName	string	Sport Name - enter sport name in all lower case. See /stats/sports/ endpoint for full list. For example: baseball, football, soccer, etc.
:leagueAbbrev	string	League URI path - Enter league URI path in all lower case. See /stats/[sport]/leagues endpoint for full list. For example: mlb, nfl, epl, etc.
accept	string	Preferred response type. Default - json

Australian Football - Teams

List Methods

Expand Methods

GET Australian Football - Teams stats/australianFootball/ausfl/teams/:teamId/

Team information.

Parameter	Type	Description
:teamId	integer	A teamId returns information for that team only. If entered, then the conferenceId is ignored.
season	integer	To get team lists for a different season, enter the year as YYYY. Note: Seasons that span years like NBA 2013-2014 would be entered as 2013. Default - the current season
languageId	string	Select ID to change language of team & venue names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

Australian Football - Schedules and results

List Methods

Expand Methods

GET Australian Football - Schedules and results stats/australianFootball/ausfl/scores/:eventId/

Schedules and results

Parameter	Type	Description
:eventId	integer	Provide a specific eventID when you want information on a single game. Must be populated to use the box request. Default - basic score data will be returned using date or season, if entered, else the current days events will be returned
date	string	Will return all events from a specific date. Format: YYYYMMDD or YYYY-MM-DD. Default - if a specific game isn't requested, all games from the current date will be returned
season	integer	To get events for a different season, enter the year as YYYY. Note: Seasons that span years like NBA 2013-2014 would be entered as 2013. Default - the current season
languageId	string	Select ID to change language of country & venue names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

Australian Football - Standings

List Methods

Expand Methods

GET Australian Football - Standings stats/australianFootball/ausfl/standings/

The standings endpoint will provide the league standings, including all team data relevant to standings. For upcoming seasons, standings typically update 30 days before the start of the regular season.

Parameter	Type	Description
season	integer	To get standings for a different season, enter the year as YYYY. Note: Seasons that span years like NBA 2013-2014 would be entered as 2013. Default - the current season
expanded	string	Expanded includes additional data points for each team. Default - false
accept	string	Preferred response type. Default - json

Australian Football - Decodes

List Methods

Expand Methods

GET Australian Football - Decodes decode/australianFootball/ausfl/:decodeType

Australian Football - Decodes

Parameter	Type	Description
:decodeType	integer	The data type to be decoded.
season	integer	For seasonStructure only. To get structure for a single season, enter the year as YYYY. Note: Seasons that span years like NBA 2013-2014 would be entered as 2013. Default - the current season
allSeasons	string	For seasonStructure only. To get complete history of league, select allSeasons=TRUE. Only those permissioned for all historic data will be able to utilize the 'allSeasons' option. Default - false
languageId	string	For venues only. Select ID to change language of venue names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

MLB - Teams

List Methods

Expand Methods

GET MLB - Teams stats/baseball/mlb/teams/:teamId

The teams endpoint will be your source for team names, locations, abbreviations, and IDs. You can get information about a single team by including the teamId. If you do not include a teamId, you will get all the teams for the league

Parameter	Type	Description
:teamId	integer	Provide team ID to return information for one team. Default - Blank (returns all teams).
season	integer	To get team lists for a different season, enter the year as YYYY. Default - the current season
languageId	string	Select ID to change language of team & venue names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

MLB - Schedules, scores, box scores, play-by-play, tvl

List Methods

Expand Methods

GET MLB - If permissioned for all event information stats/baseball/mlb/events/:eventId

Access to this events endpoint will provide you with the highest level of game data including live scores, box scores, play-by-play, and pitch type/velocity/location information. The first 4 parameters (eventId, box, pbp, and tvl) are only applicable for a specific game.
Events will also provide you with schedule data.

Parameter	Type	Description
:eventId	integer	Provide a specific eventID when you want information on a single game. Must be populated to use the box, pbp (play-by-play) and tvl parameters. Default - Basic score & schedule data for the data will be returned using date or season, if entered, else the current days events will be returned
box	string	Returns the box score for a specific in-progress or concluded event. An eventId must also be entered in conjunction with 'box=true'. Default - box score data will not be returned
pbp	string	Returns the play-by-play for a specific in-progress or concluded event. An eventId must also be entered in conjunction with 'pbp=true'. Default - pbp data will not be returned
tvl	string	Returns the play-by-play along with pitch type, velocity, & location for a specific in-progress or concluded event. An eventId must also be entered in conjunction with 'tvl=true'. Default - tvl data will not be returned
linescore	string	Linescores are only returned when requested and will be returned for all events in the results. Default - false, line score data will not be returned
sch	string	Returns schedule modified events. Default - false, modified events will not be returned
time	integer	Returns schedule modified events based on the time entered. Default - 1, returns modified events of last 24hrs
startDate	string	If used, startDate and endDate must both be entered. Dates cannot span across multiple seasons. All items between the two dates (inclusive) will be returned. Calls using between dates will take more time to return. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
endDate	string	If used, startDate and endDate must both be entered. All items between the two dates (inclusive) will be returned. Calls using between dates will take more time to return. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
date	string	Will return all games from a specific date. This parameter is ignored in an eventId is used. Format: YYYYMMDD or YYYY-MM-DD. Default - Blank - All the games for the current day.
season	integer	Provides a list of games, IDs for the current season. Endpoint not optimized to retrieve scores, linescores, boxscores or play-by-plays. To obtain a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - All game types
languageId	string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - If permissioned for all event information - for one team only stats/baseball/mlb/events/teams/:teamId

This endpoint allows you to select schedule and score information for just one team. Getting information for a single team returns only schedule and score information. If you want detailed event information (box, pbp, tvl), refer to the endpoint example with the eventId.

Parameter	Type	Description
:teamId	integer	Provide a teamId when you want information for just that team. 'box', 'pbp', and 'tvl' parameters are not allowed because you are requesting schedule information for a team, not an individual event. Default - basic score data will be returned using date or season, if entered, else the current days events will be returned
linescore	string	Linescores are only returned when requested and will be returned for all events in the results. Default - false, line score data will not be returned
startDate	string	If used, startDate and endDate must both be entered. Dates cannot span across multiple seasons. All items between the two dates (inclusive) will be returned. Calls using between dates will take more time to return. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
endDate	string	If used, startDate and endDate must both be entered. All items between the two dates (inclusive) will be returned. Calls using between dates will take more time to return. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
date	string	Will return all games from a specific date. Format: YYYYMMDD or YYYY-MM-DD. Default - if a specific game isn't requested, games from the current date will be returned
season	integer	Provides a list of games, IDs for the current season. Endpoint not optimized to retrieve scores, linescores, boxscores or play-by-plays. To obtain a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - All game types
languageId	string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - If permissioned for just schedules, scores and box scores stats/baseball/mlb/box/:eventId

The box/ resource provides scores/schedules and box score information for MLB events. (Play-by-play is not an option.)

Parameter	Type	Description
:eventId	integer	Provide a specific eventID when you want information on a single game. Must be populated to use the box request. Default - basic score data will be returned using date or season, if entered, else the current days events will be returned
box	string	Returns the box score for a specific in-progress or concluded event. An eventId must also be entered in conjunction with 'box=true'. Default - box score data will not be returned
linescore	string	Linescores are only returned when requested and will be returned for all events in the results. Default - false, line score data will not be returned
date	string	Will return all games from a specific date. Format: YYYYMMDD or YYYY-MM-DD. Default - if a specific game isn't requested, games from the current date will be returned
season	integer	Provides a list of games, IDs for the current season. Endpoint not optimized to retrieve scores, linescores, boxscores or play-by-plays. To obtain a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - All game types
languageId	string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - If permissioned for just schedules, scores and box scores - for one team only stats/baseball/mlb/box/teams/:teamId

This gets the event (schedule) information for just one team. (Use the example above to return detailed event information.

Parameter	Type	Description
:teamId	integer	Provide a teamId when you want information for just that team. The 'box' parameter is not allowed because you are requesting schedule information for a team, not an individual event. Default - basic score data will be returned using date or season, if entered, else the current days events will be returned
linescore	string	Linescores are only returned when requested and will be returned for all events in the results. Default - false, line score data will not be returned
date	string	Will return games from a specific date. Format: YYYYMMDD or YYYY-MM-DD. Default - if a specific game isn't requested, games from the current date will be returned
season	integer	Provides a list of games, IDs for the current season. Endpoint not optimized to retrieve scores, linescores, boxscores or play-by-plays. To obtain a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - All game types
languageId	string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type

GET MLB - If permissioned for just schedules and scores stats/baseball/mlb/scores/:eventId

The scores/ resource provides score and schedule information for MLB events. (Box and Play-by-play are not options.)

Parameter	Type	Description
:eventId	integer	Provide a specific eventID when you want information on a single game. Default - basic score data will be returned using date or season, if entered, else the current days events will be returned
linescore	string	Linescores are only returned when requested and will be returned for all events in the results. Default - false, line score data will not be returned
date	string	Will return all games from a specific date. Format: YYYYMMDD or YYYY-MM-DD. Default - if a specific game isn't requested, games from the current date will be returned
season	integer	Provides a list of games, IDs for the current season. Endpoint not optimized to retrieve scores. To obtain a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - All game types
languageId	string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - If permissioned for just schedules and scores - for one team only stats/baseball/mlb/scores/teams/:teamId

The scores/ resource provides score and schedule information for MLB events.

Parameter	Type	Description
:teamId	integer	Provide a teamId when you want information for just that team. Default - basic score data will be returned using date or season, if entered, else the current days events will be returned
linescore	string	Linescores are only returned when requested and will be returned for all events in the results. Default - false, line score data will not be returned
date	string	Will return games from a specific date. Format: YYYYMMDD or YYYY-MM-DD. Default - if a specific game isn't requested, games from the current date will be returned
season	integer	Provides a list of games, IDs for the current season. Endpoint not optimized to retrieve scores. To obtain a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - All game types
languageId	string	Select ID to change language of player names, team names, and venues. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type

MLB - Standings

List Methods

Expand Methods

GET MLB - Standings stats/baseball/mlb/standings/

Parameter	Type	Description
expanded	string	Expanded includes additional data points for each team. Default - false
wildCard	string	Default - false
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - Regular Season
season	integer	Used for historical seasons. For fastest updates of current seasons, leave this option empty, making the endpoint to default to the current season. For historical season standings, enter the year as YYYY. Entering the current season as a parameter will work, but the endpoint does not update as frequently. Note: Seasons that span years, such as 2020-2021, would be entered as 2020. Default - the current season
accept	string	Preferred response type. Default - json

GET MLB - Standings for a single team stats/baseball/mlb/standings/teams/:teamId

The standings endpoint will provide the league standings, including all team data relevant to standings.

Parameter	Type	Description
:teamId	integer	Provide team ID to return information for one team.
expanded	string	Expanded includes additional data points for each team. Default - false
wildCard	string	Default - false
eventTypeId	integer	Schedule will be returned for games included in the specified eventType. Default - Regular Season
season	integer	Used for historical seasons. For fastest updates of current seasons, leave this option empty, making the endpoint to default to the current season. For historical season standings, enter the year as YYYY. Entering the current season as a parameter will work, but the endpoint does not update as frequently. Note: Seasons that span years, such as 2020-2021, would be entered as 2020. Default - the current season
accept	string	Preferred response type. Default - json

MLB - Participants

List Methods

Expand Methods

GET MLB - Players stats/baseball/mlb/participants/

The participants endpoint provides biographical information for players and can be used to return information on a single player, a single teams roster, all teams rosters within the league, or all free agents. Historical participants are not supported. Instead of historical participants, an alternative is to use a list of players who have accumulated statsistics.

Parameter	Type	Description
freeAgent	string	Indicates whether Free Agents should be included in participants list. Default - no free agents will be returned in the results.
freeAgentSinceYear	integer	Applicable only if you have also requested to have Free Agents returned in the results. Enter year as YYYY. Default - all current free agents
sinceYearLast	integer	Anyone who last played since the requested year. Enter year as YYYY. Default -
languageId	string	Select ID to change language of team & player names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - All players since season YYYY stats/baseball/mlb/participants/

This will return anyone who has played since the beginning of the entered year.

Parameter	Type	Description
sinceYearLast	integer	Anyone who last played since the requested year. Enter year as YYYY. Default -
languageId	string	Select ID to change language of team & player names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - All players on a single team stats/baseball/mlb/participants/teams/:teamId

Parameter	Type	Description
:teamId	integer	Provide team ID to return roster for one team.
freeAgent	string	Indicates whether Free Agents should be included in participants list. Default - no free agents will be returned in the results.
freeAgentSinceYear	integer	Applicable only if you have also requested to have Free Agents returned in the results. Enter year as YYYY. Default - all current free agents
languageId	string	Select ID to change language of team & player names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Historical Rosters stats/baseball/mlb/participants/teams/:teamId

Historical rosters provide biographical information for players that played for a team in a single specified season.

Parameter	Type	Description
:teamId	integer	Provide team ID to return roster for one team.
season	integer	Enter the year as YYYY.
languageId	string	Select ID to change language of team & player names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Single player stats/baseball/mlb/participants/:playerId

Parameter	Type	Description
:playerId	integer	To get information on a specific player, enter their ID.
freeAgent	string	Indicates whether Free Agents should be included in participants list. Default - no free agents will be returned in the results.
freeAgentSinceYear	integer	Applicable only if you have also requested to have Free Agents returned in the results. Enter year as YYYY. Default - all current free agents
languageId	string	Select ID to change language of team & player names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - All-Star Game players stats/baseball/mlb/allStarParticipants/

This will return anyone who has played in an MLB All-Star Game.

Parameter	Type	Description
season	integer	Enter year as YYYY. Default - The current season.
languageId	string	Select ID to change language of team & player names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Umpires stats/baseball/mlb/umpires/

The umpires endpoint provides biographical information for umpires.

Parameter	Type	Description
sinceYearLast	integer	Returns all umpires who participated since the requested year. Enter year as YYYY.
languageId	string	Select ID to change language of umpire & country names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Single umpire stats/baseball/mlb/umpires/:umpireId

The umpires endpoint provides biographical information on a single umpire.

Parameter	Type	Description
:umpireId	integer	To get information on a specific umpire, enter their ID.
languageId	string	Select ID to change language of umpire & country names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

MLB - MLB Ids

List Methods

Expand Methods

GET MLB - Players stats/baseball/mlb/mlbid/

The mlbid endpoint provides the MLB ids for players. It can be used to return the MLB id on a single player, a single teams roster, all teams rosters within the league, or all free agents.

Parameter	Type	Description
freeAgent	string	Indicates whether Free Agents should be included in the list. Default - no free agents will be returned in the results.
freeAgentSinceYear	integer	Applicable only if you have also requested to have Free Agents returned in the results. Enter year as YYYY. Default - all current free agents
sinceYearLast	integer	Anyone who last played since the requested year. Enter year as YYYY. Default -
accept	string	Preferred response type. Default - json

GET MLB - All players since season YYYY stats/baseball/mlb/mlbid/

This will return anyone who has played since the beginning of the entered year.

Parameter	Value	Type	Description
sinceYearLast		integer	Anyone who last played since the requested year. Enter year as YYYY. Default -
accept		string	Preferred response type. Default - json

GET MLB - All players on a single team stats/baseball/mlb/mlbid/teams/:teamId

The mlbid endpoint provides MLB ids for players. It can be used to return the MLB id on a single player, a single teams roster, all teams rosters within the league, or all free agents.

Parameter	Type	Description
:teamId	integer	Provide team ID to return roster for one team.
freeAgent	string	Indicates whether Free Agents should be included in the list. Default - no free agents will be returned in the results.
freeAgentSinceYear	integer	Applicable only if you have also requested to have Free Agents returned in the results. Enter year as YYYY. Default - all current free agents
accept	string	Preferred response type. Default - json

GET MLB - Historical Rosters stats/baseball/mlb/mlbid/teams/:teamId

Historical rosters provide MLB ids for players that played for a team in a single specified season.

Parameter	Type	Description
:teamId	integer	Provide team ID to return roster for one team.
season	integer	Enter the year as YYYY.
accept	string	Preferred response type. Default - json

GET MLB - Single player stats/baseball/mlb/mlbid/:playerId

The mlbid endpoint provides MLB ids for players. It can be used to return MLB ids on a single player, a single teams roster, all teams rosters within the league, or all free agents.

Parameter	Type	Description
:playerId	integer	To get information on a specific player, enter their ID.
freeAgent	string	Indicates whether Free Agents should be included in the list. Default - no free agents will be returned in the results.
freeAgentSinceYear	integer	Applicable only if you have also requested to have Free Agents returned in the results. Enter year as YYYY. Default - all current free agents
accept	string	Preferred response type. Default - json

MLB - Statistics

List Methods

Expand Methods

GET MLB - Player stats - Year-to-date stats/baseball/mlb/stats/players/:playerId

MLB - Season stats for a single player
Note: Please avoid calling for stats of players who have not accumulated statistics for the season in question.
* The easiest way to avoid this string of unsuccesful calls is to first call for player by team:api.stats.com/v1/stats/players/?teamId=7149&season=2014 (check below method).
- Please make sure to always include &teamId for these current,year-to-year player stats calls.
* If you are looking for additional stats above and beyond YTD calls (e.g. player encyclopedia or individual player splits), use the above technique to first get and your set of playerId's who have accured YTD data, and then call those players one by one for encyclopedia or splits data.

Parameter	Type	Description
:playerId	integer	Player Id.
eventTypeId	integer	Statistics for games in the specified eventType only. Default - Regular Season
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Player stats - Year-to-date - by Team stats/baseball/mlb/stats/players

MLB - Season stats for players

Parameter	Type	Description
teamId	integer	Team Id.
eventTypeId	integer	Statistics for games in the specified eventType only. Default - Regular Season
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Player stats - Career stats/baseball/mlb/stats/players/:playerId

MLB - Career stats for a single player

Parameter	Type	Description
:playerId	integer	Player Id.
eventTypeId	integer	Statistics for games in the specified eventType only. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds
enc	string	The 'encyclopedia returns full career and season-by-season totals. Notes: The encyclopedia is valid for a single player only. If playerId is omitted, 'enc=true' will be ignored. If 'enc=true', the seasonId will be ignored if included. Default - the current season
careerOnly	boolean	For a single player's career stats, only to be used in conjunction with 'enc=true'
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Player single game stats stats/baseball/mlb/stats/players/:playerId/events/:eventId

MLB - Single game stats for a single player

Parameter	Type	Description
:playerId	integer	Player Id.
:eventId	integer	Statistics for a single game.
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Player game-by-game stats stats/baseball/mlb/stats/players/:playerId/events/

MLB - Player game logs.

Parameter	Type	Description
:playerId	integer	Player Id.
eventTypeId	integer	Games logs for the specified eventType only. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Player stats while on one team. stats/baseball/mlb/stats/players/:playerId/teams/:teamId

This is used when a player is on more than one team in a season and you want only stats for one specific team.

Parameter	Type	Description
:playerId	integer	Player Id.
:teamId	integer	To get statistics for the player above on one team only, enter team ID.
eventTypeId	integer	Statistics for games in the specified eventType only. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Player splits stats/baseball/mlb/stats/players/:playerId/

MLB - Player splits (breakdowns).

Parameter	Type	Description
:playerId	integer	Player Id.
splitId	string	Enter the stat split to be returned. (The decodes resource provides a list of available codes.) 1. If omitted, only official total stats (splitId = -1) will be returned. 2. If 'all', all the splits are returned. 3. Otherwise, the entered split is returned. Default - Official totals (splitId = -1)
eventTypeId	integer	Splits for games in the specified eventType only. Default - Regular Season
eventRoundId	integer	Splits among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Team stats stats/baseball/mlb/stats/teams/:teamId/

MLB - Team stats

Parameter	Type	Description
:teamId	integer	Provide team ID to statistics for one team.
eventTypeId	integer	Statistics for games in the specified eventType only. Default - Regular Season
eventRoundId	integer	Splits among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Team single game stats stats/baseball/mlb/stats/teams/:teamId/events/:eventId

MLB - Single game stats for a team

Parameter	Type	Description
:teamId	integer	Team ID.
:eventId	integer	Game ID.
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Team game-by-game stats stats/baseball/mlb/stats/teams/:teamId/events/

MLB - Team game logs.

Parameter	Type	Description
:teamId	integer	Team ID.
eventTypeId	integer	Game logs for games in the specified eventType only. Default - Regular Season
eventRoundId	integer	Game logs among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Team splits stats/baseball/mlb/stats/teams/:teamId/

MLB - Team splits (breakdowns).

Parameter	Type	Description
:teamId	integer	Team ID.
splitId	string	Enter the stat split to be returned. (The decodes resource provides a list of available codes.) 1. If omitted, only official total stats (splitId = -1) will be returned. 2. If 'all', all the splits are returned. 3. Otherwise, the entered split is returned. Default - Official totals (splitId = -1)
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
eventTypeId	integer	Splits for games in the specified eventType only. Default - Regular Season
eventRoundId	integer	Game logs among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
languageId	string	Select ID to change language of player & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Coach stats - Year-to-date stats/baseball/mlb/stats/coaches/:coachId

MLB - Season stats for a single coach

Parameter	Type	Description
:coachId	integer	Coach Id.
season	integer	To get data for a different season, enter the year as YYYY. Note: Seasons that span years like MLB 2013-2014 would be entered as 2013. Default - the current season
eventTypeId	integer	Result will return only coach stats for the specific eventType. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
splitId	string	Enter the stat split to be returned. (The decodes resource provides a list of available codes.) 1. If omitted, only total stats (splitId = 0) will be returned. 2. If 'all', all the splits are returned. 3. Otherwise, the entered split is returned. Default - totals (splitId = 0)
teamId	integer	To get data for coaches on one team only, enter the teamId. Default - all coaches
languageId	string	Select ID to change language of coach & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Coach stats while on one team stats/baseball/mlb/stats/coaches/:coachId/teams/:teamId

This is used when a coach is on more than one team in a season and you want only the stats for that team.

Parameter	Type	Description
:coachId	integer	Coach Id.
season	integer	To get data for a different season, enter the year as YYYY. Note: Seasons that span years like MLB 2013-2014 would be entered as 2013. Default - the current season
eventTypeId	integer	Result will return only coach stats for the specific eventType. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
splitId	string	Enter the stat split to be returned. (The decodes resource provides a list of available codes.) 1. If omitted, only total stats (splitId = 0) will be returned. 2. If 'all', all the splits are returned. 3. Otherwise, the entered split is returned. Default - totals (splitId = 0)
:teamId	integer	To get statistics for the coach above on one team only, enter team ID.
languageId	string	Select ID to change language of coach & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - All coach stats for one team - Year-to-date stats/baseball/mlb/stats/coaches/teams/:teamId

This will return all stats for all coaches on a team in a given season.

Parameter	Type	Description
season	integer	To get data for a different season, enter the year as YYYY. Note: Seasons that span years like MLB 2013-2014 would be entered as 2013. Default - the current season
eventTypeId	integer	Result will return only coach stats for the specific eventType. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
splitId	string	Enter the stat split to be returned. (The decodes resource provides a list of available codes.) 1. If omitted, only total stats (splitId = 0) will be returned. 2. If 'all', all the splits are returned. 3. Otherwise, the entered split is returned. Default - totals (splitId = 0)
:teamId	integer	To get all coach stats for one team, enter team ID.
languageId	string	Select ID to change language of coach & team names. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Coach stats - Career stats/baseball/mlb/stats/coaches/:coachId

MLB - Career stats for a single coach

Parameter	Type	Description
:coachId	integer	Coach Id.
eventTypeId	integer	Result will return only coach stats for the specific eventType. Default - Regular Season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
splitId	string	Enter the stat split to be returned. (The decodes resource provides a list of available codes.) 1. If omitted, only total stats (splitId = 0) will be returned. 2. If 'all', all the splits are returned. 3. Otherwise, the entered split is returned. Default - totals (splitId = 0)
enc	string	The encyclopedia returns full career and season-by-season totals. Notes: The encyclopedia is valid for a single coach only. If coachId is omitted, 'enc=true' will be ignored. If 'enc=true', the seasonId will be ignored if included. Default - the current season
languageId	string	Select ID to change language of umpires. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

GET MLB - Umpire stats - Year-to-date stats/baseball/mlb/stats/umpires/:umpireId

MLB - Season stats for a single umpire

Parameter	Type	Description
:umpireId	integer	Umpire Id.
eventTypeId	integer	Statistics for games in the specified eventType only. Default - Regular Season
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
eventRoundId	integer	Statistics among games in the specified eventRound only. Rounds are only relevant when eventTypeId = 2 (Postseason) is selected Default - all rounds combined
languageId	string	Select ID to change language of umpire. Not all languages available for every name. Default - English is returned when no ID is selected.
accept	string	Preferred response type. Default - json

MLB - Draft

List Methods

Expand Methods

GET MLB - Draft stats/baseball/mlb/draft/

MLB - Draft

Parameter	Type	Description
season	integer	To get data for a different season, enter the year as YYYY. Note: Seasons that span years like MLB 2013-2014 would be entered as 2013. Default - the current season
roundNumber	integer	Return draft picks for a specifc round only. Default - all rounds
accept	string	Preferred response type. Default - json

GET MLB - Draft by team stats/baseball/mlb/draft/teams/:teamId

MLB - Draft

Parameter	Type	Description
:teamId	integer	Provide team ID to return information for one team.
season	integer	To get data for a different season, enter the year as YYYY. Note: Seasons that span years like MLB 2013-2014 would be entered as 2013. Default - the current season
roundNumber	integer	Return draft picks for a specifc round only. Default - all rounds
accept	string	Preferred response type. Default - json

MLB - Transactions

List Methods

Expand Methods

GET MLB - Transactions stats/baseball/mlb/transactions/

MLB - Get all transactions

Parameter	Type	Description
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
startDate	string	If used, startDate and endDate must both be entered. Dates cannot span across multiple seasons. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
endDate	string	If used, startDate and endDate must both be entered. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
accept	string	Preferred response type. Default - json

GET MLB - Transactions by player stats/baseball/mlb/transactions/players/:playerId/

MLB - Player transactions

Parameter	Type	Description
:playerId	integer	To get information on a specific player, enter their ID.
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
startDate	string	If used, startDate and endDate must both be entered. Dates cannot span across multiple seasons. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
endDate	string	If used, startDate and endDate must both be entered. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
accept	string	Preferred response type. Default - json

GET MLB - Transactions by player on a specific team stats/baseball/mlb/transactions/players/:playerId/teams/:teamId/

MLB - Player transactions

Parameter	Type	Description
:playerId	integer	To get information on a specific player, enter their ID.
:teamId	integer	To get information for the above player on only one team, enter the appropriate team ID.
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
startDate	string	If used, startDate and endDate must both be entered. Dates cannot span across multiple seasons. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
endDate	string	If used, startDate and endDate must both be entered. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
accept	string	Preferred response type. Default - json

GET MLB - Transactions by team stats/baseball/mlb/transactions/teams/:teamId

MLB - Team transactions

Parameter	Type	Description
:teamId	integer	Provide team ID to return information for one team.
season	integer	To get data for a different season, enter the year as YYYY. Default - the current season
startDate	string	If used, startDate and endDate must both be entered. Dates cannot span across multiple seasons. All items between the two dates (inclusive) will be returned. Format: YYYYMMDD or YYYY-MM-DD. Default - If not used, the last 7 days items will be returned.
endDate	string	If used, startDate and endDate must both be entered. All items between the two

I/O Docs

Please note:

This web application will sometimes take a long time to display the results when you click "Try it!" than it does to actually receive the data. You can confirm how long it takes for STATS to process the request by looking at the timeTaken node in the results body.

Resources shared across sports and leagues.

Australian Football

MLB - Major League Baseball

Baseball - Other

CBK - College Basketball

NBA - National Basketball Association

Basketball - Other

WCBK - Women's College Basketball

WNBA - Women National Basketball Association

Boxing

CFB - College Football

NFL - National Football League

Football - Other

Golf

NHL - National Hockey League

Hockey - Other

horseRacing

UFC - Ultimate Fighting Championship

Motor

Rugby

Soccer

Sumo

Tennis

Volleyball

Shared Resources List Methods Expand Methods

Australian Football - Teams List Methods Expand Methods

Australian Football - Schedules and results List Methods Expand Methods

Australian Football - Standings List Methods Expand Methods

Australian Football - Decodes List Methods Expand Methods

MLB - Teams List Methods Expand Methods

MLB - Schedules, scores, box scores, play-by-play, tvl List Methods Expand Methods

MLB - Standings List Methods Expand Methods

MLB - Participants List Methods Expand Methods

MLB - MLB Ids List Methods Expand Methods

MLB - Statistics List Methods Expand Methods

MLB - Draft List Methods Expand Methods

MLB - Transactions List Methods Expand Methods

Shared Resources

List Methods

Expand Methods

Australian Football - Teams

List Methods

Expand Methods

Australian Football - Schedules and results

List Methods

Expand Methods

Australian Football - Standings

List Methods

Expand Methods

Australian Football - Decodes

List Methods

Expand Methods

MLB - Teams

List Methods

Expand Methods

MLB - Schedules, scores, box scores, play-by-play, tvl

List Methods

Expand Methods

MLB - Standings

List Methods

Expand Methods

MLB - Participants

List Methods

Expand Methods

MLB - MLB Ids

List Methods

Expand Methods

MLB - Statistics

List Methods

Expand Methods

MLB - Draft

List Methods

Expand Methods

MLB - Transactions

List Methods

Expand Methods