Stats

View stats

get/api/v1/stats/grouped

Request

Base URL: https://statsapi.mlb.com
URL: https://statsapi.mlb.com/api/v1/stats/grouped
Auth: none declared

Query parameters

statsStatType[] required

Type of statistics. Format: Individual, Team, Career, etc. Available types in /api/v1/statTypes

personIdinteger

Unique Player Identifier. Format: 434538, 429665, etc

teamIdinteger

Unique Team Identifier. Format: 141, 147, etc

teamIdsinteger[]

Comma delimited list of Unique Team identifiers

groupStatGroup[] required

Category of statistic to return. Available types in /api/v1/statGroups

gameType'SPRING_TRAINING' | 'REGULAR_SEASON' | 'FIRST_ROUND' | 'DIVISION_SERIES' | 'LEAGUE_CHAMPIONSHIP_SERIES' | 'WORLD_SERIES' | 'CHAMPIONSHIP' | 'NINETEENTH_CENTURY_SERIES' | 'PLAYOFFS' | 'ALL_STAR' | 'INTRASQUAD' | 'EXHIBITION'

Type of Game. Available types in /api/v1/gameTypes

seasonstring

Season of play

seasonsstring[]

Comma delimited list of Seasons of play

sportIdinteger

Top level organization of a sport

sportIdsinteger[]

Comma delimited list of top level organizations of a sport

leagueIdinteger

Unique League Identifier

leagueIdsinteger[]

Comma delimited list of Unique league identifiers

leagueListId'MILB_FULL' | 'MILB_SHORT' | 'MILB_COMPLEX' | 'MILB_ALL' | 'MILB_ALL_NOMEX' | 'MILB_ALL_DOMESTIC' | 'MILB_NONCOMP' | 'MILB_NONCOMP_NOMEX' | 'MILB_DOMCOMP' | 'MILB_INTCOMP' | 'WIN_NOABL' | 'WIN_CARIBBEAN' | 'WIN_ALL' | 'ABL' | 'MEX_ALL' | 'MLB' | 'MLB_HIST' | 'MLB_MILB' | 'MLB_MILB_HIST' | 'MLB_MILB_WIN' | 'BASEBALL_ALL' | 'MLB_SPRING'

Unique League List Identifier

metricsMetricType[]

Name of metric(s) for metric log stats. Available metrics in /api/v1/metrics

gamePkinteger

Unique Primary Key Representing a Game

batterTeamIdinteger[]

A unique identifier for the batter's team

pitcherTeamIdinteger[]

A unique identifier for the pitcher's team

batterIdinteger

Unique Player Identifier. Format: 434538, 429665, etc

pitcherIdinteger

Unique Player Identifier. Format: 434538, 429665, etc

sitCodesstring[]

Situation code for a given stat split.

combineSitsboolean

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

opposingTeamIdinteger

A unique identifier for the opposing team. Must be used with Team ID

fieldsstring[]

Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute

sortStat'AIROUTS' | 'ASSISTS' | 'AT_BATS' | 'AT_BATS_PER_HOMERUN' | 'BALK' | 'BATTING_AVERAGE' | 'BATTING_AVERAGE_BALLS_IN_PLAY' | 'QUALITY_STARTS' | 'BEQUEATHED_RUNNERS' | 'BEQUEATHED_RUNNERS_SCORED' | 'BLOWN_SAVES' | 'CATCHER_ERA' | 'CATCHERS_INTERFERENCE' | 'CAUGHT_STEALING' | 'CHANCES' | 'COMPLETE_GAME' | 'DOUBLE_PLAYS' | 'DOUBLES' | 'EARNED_RUN' | 'EARNED_RUN_AVERAGE' | 'ERRORS' | 'EXIT_VELOCITY' | 'EXTRA_BASE_HITS' | 'FIELDING_PERCENTAGE' | 'FLYOUTS' | 'GAMES_FINISHED' | 'GAMES_PLAYED' | 'GAMES_STARTED' | 'GROUND_INTO_DOUBLE_PLAYS' | 'GROUND_INTO_DOUBLE_PLAY_OPPORTUNITIES' | 'GROUND_INTO_TRIPLE_PLAYS' | 'GROUNDOUTS' | 'GROUNDOUT_TO_FLYOUT_RATIO' | 'HITS' | 'HITS_RISP' | 'HIT_BATSMAN' | 'HIT_BY_PITCHES' | 'HITS_PER_9_INN' | 'HOLDS' | 'HOME_RUNS' | 'HOME_RUNS_PER_PLATE_APPEARANCE' | 'INHERITED_RUNNER' | 'INHERITED_RUNNER_SCORED' | 'INNINGS' | 'OUTS_PITCHED' | 'INNINGS_PITCHED' | 'INTENTIONAL_WALKS' | 'ISO' | 'LEFT_ON_BASE' | 'LEFT_ON_BASE_RISP' | 'LOSSES' | 'NUMBER_OF_STRIKES' | 'NUMBER_OF_BALLS' | 'NUMBER_OF_PITCHES' | 'ON_BASE_PERCENTAGE' | 'ON_BASE_PLUS_SLUGGING' | 'OUTFIELD_ASSISTS' | 'UZR' | 'PASSED_BALLS' | 'PICKOFFS' | 'PITCHES_PER_INNING' | 'PITCHES_PER_PLATE_APPEARANCE' | 'PUT_OUTS' | 'RANGE_FACTOR_PER_GAME' | 'RANGE_FACTOR_PER_9_INN' | 'REACHED_ON_ERROR' | 'RUNS' | 'RUNS_BATTED_IN' | 'SACRIFICE_BUNTS' | 'SACRIFICE_FLIES' | 'SAVES' | 'SAVE_OPPORTUNITIES' | 'SHUTOUTS' | 'SLUGGING_PERCENTAGE' | 'STOLEN_BASES' | 'STOLEN_BASE_PERCENTAGE' | 'STRIKEOUTS' | 'STRIKEOUTS_PER_9_INN' | 'STRIKEOUTS_PER_PLATE_APPEARANCE' | 'STRIKEOUT_WALK_RATIO' | 'THROWING_ERRORS' | 'TOTAL_BASES' | 'TOTAL_BATTERS_FACED' | 'TOTAL_PLATE_APPEARANCES' | 'TRIPLE_PLAYS' | 'TRIPLES' | 'WALKS_PER_STRIKEOUT' | 'WALKS_PER_PLATE_APPEARANCE' | 'WALKS_HITS_PER_INNING_PITCHED' | 'WALKS' | 'WALKS_PER_9_INN' | 'WALKOFFS' | 'WILD_PITCH' | 'WINS' | 'WIN_PERCENTAGE' | 'ATTENDANCE' | 'DURATION' | 'WIN_STREAK' | 'LOSS_STREAK' | 'WOBA' | 'XWOBA' | 'XWOBACON' | 'XAVG' | 'XSLG' | 'LAUNCH_ANGLE' | 'HOME_RUN_DISTANCE' | 'HIT_DISTANCE' | 'HANG_TIME' | 'MAX_HEIGHT' | 'HIT_PROBABILITY' | 'CATCH_PROBABILITY' | 'BARRELS' | 'PITCH_SPEED' | 'SPIN_RATE' | 'EXTENSION' | 'HORIZONTAL_BREAK' | 'ARM_STRENGTH' | 'DISTANCE_COVERED' | 'EXCHANGE' | 'FIELDER_BURST_DISTANCE' | 'FIELDER_JUMP_DISTANCE' | 'FIELDER_REACTION_DISTANCE' | 'FIRST_STEP' | 'FIRST_STEP_EFFICIENCY' | 'POP_TIME_1B' | 'POP_TIME_2B' | 'POP_TIME_3B' | 'ROUTE_EFFICIENCY' | 'SPRINT_SPEED' | 'THROW_ACCURACY' | 'THROW_DISTANCE' | 'THROW_DISTANCE_WITH_BOUNCES' | 'ACCELERATION' | 'BURST' | 'FIRST_TO_HOME' | 'FIRST_TO_SECOND' | 'FIRST_TO_THIRD' | 'HOME_RUN_TROT' | 'HOME_TO_FIRST' | 'HOME_TO_SECOND' | 'HOME_TO_THIRD' | 'LEAD_DISTANCE' | 'OUT_OF_BOX' | 'SECOND_TO_HOME' | 'SECOND_TO_THIRD' | 'SECONDARY_LEAD_DISTANCE' | 'STEAL_FIRST_TO_SECOND' | 'STEAL_SECOND_TO_THIRD' | 'STEAL_THIRD_TO_HOME' | 'TAG_FIRST_STEP' | 'TAG_FIRST_TO_SECOND' | 'TAG_SECOND_TO_THIRD' | 'TAG_THIRD_TO_HOME' | 'THIRD_TO_HOME' | 'OUTS_ABOVE_AVERAGE' | 'FIELDING_RUNS_PREVENTED' | 'STREAK' | 'WINS_ABOVE_REPLACEMENT' | 'GAME_DATE' | 'VERTICAL_BREAK' | 'BURST_DISTANCE' | 'WEIGHTED_RUNS_ABOVE_AVERAGE' | 'WEIGHTED_RUNS_CREATED' | 'WEIGHTED_RUNS_CREATED_PLUS' | 'RUNS_ABOVE_REPLACEMENT' | 'BATTING_RUNS_ABOVE_AVG' | 'FIELDING_RUNS_ABOVE_AVG' | 'POSITIONAL_RUNS_ABOVE_AVG' | 'BASE_RUNNING_RUNS_ABOVE_AVG' | 'WEIGHTED_LEAGUE_ADJUST' | 'REPLACEMENT_RUNS' | 'SPEED_SCORE' | 'ULTIMATE_BASE_RUNNING' | 'WEIGHTED_NOT_GROUND_INTO_DP_RUNS' | 'WEIGHTED_STOLEN_BASE_RUNS' | 'FIELDING_INDEPENDENT_PITCHING' | 'EXPECTED_FIELDING_INDEPENDENT_PITCHING' | 'FIELDING_INDEPENDENT_PITCHING_MINUS' | 'RUNS_ALLOWED_BASED_WAR' | 'SHUTDOWNS' | 'MELTDOWNS' | 'PITCHER_AVERAGE_LEVERAGE_INDEX' | 'INNING_AVERAGE_LEVERAGE_INDEX' | 'GAME_AVERAGE_LEVERAGE_INDEX' | 'END_OF_APPEARANCE_AVERAGE_LEVERAGE_INDEX' | 'ERA_MINUS' | 'JUMP_DISTANCE'

Baseball stat to sort splits by.

order'ASC' | 'DESC'

The order of sorting, ascending or descending

playerPool'ALL' | 'QUALIFIED' | 'ROOKIES' | 'QUALIFIED_ROOKIES' | 'ORGANIZATION' | 'ORGANIZATION_NO_MLB' | 'CURRENT' | 'ALL_CURRENT' | 'QUALIFIED_CURRENT'

Return "ALL" or only "QUALIFIED" players based on plate appearances.

positionBaseballPosition[]

Position number. Format: 1, 2, 3, etc

startDatestring date

Start date for range of data (must be used with end date). Format: MM/DD/YYYY

endDatestring date

End date for range of data (must be used with start date). Format: MM/DD/YYYY

daysBackinteger

Returns results from the last 'X' days (Starting from yesterday).

gamesBackinteger

Returns results from the last 'X' games played.

excludeTradedPlayersboolean

Excludes players who have since been traded from the input team

offsetinteger

The pointer to start for a return set; used for pagination

limitinteger

Number of results to return

statFieldsStatField[]

Baseball stat fields to populate

sortField'STANDARD' | 'ADVANCED' | 'TRACKING' | 'EXPECTED' | 'SABERMETRICS' | 'RANKING' | 'PERCENTILE'

Baseball statField to sort on. If no statField is given, sortField defaults to BASIC. If 1 statField is given, that is the default sortField.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.