---
title: "Player Season Split Stats"
method: GET
path: "/v3/mlb/stats/{format}/PlayerSeasonSplitStats/{season}/{split}"
tags: ["MLB v3 Stats"]
---

# Player Season Split Stats

`GET /v3/mlb/stats/{format}/PlayerSeasonSplitStats/{season}/{split}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/mlb/stats/{format}/PlayerSeasonSplitStats/{season}/{split}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/mlb-api/docs/v3/mlb/stats/:format/PlayerSeasonSplitStats/:season/:split/get.ts> (a function with typed inputs; its response is checked against the schema)

All players' split stats for the season. Split stats are available for left, right, and switch-handed pitchers and hitters.

## Path parameters

- `format` 'JSON' | 'XML', required
- `season` string, required
- `split` 'L' | 'R' | 'S', required

## Response `200`

Success

- PlayerSeason[]
  - `StatID` integer: The unique ID of the stat
  - `TeamID` integer, nullable: The team's unique TeamID as assigned by SportsDataIO
  - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their MLB career
  - `SeasonType` integer, nullable: The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar)
  - `Season` integer, nullable: The MLB season for which these totals apply
  - `Name` string, nullable: Player's full name
  - `Team` string, nullable: The abbreviation [Key] of the team
  - `Position` string, nullable: The player's position associated with the given game or season. Possible values: 1B; 2B; 3B; C; CF; DH; IF; LF; OF; P; PH; PR; RF; RP; SP; SS
  - `PositionCategory` string, nullable: The player's position category. Possible values: DH; IF; OF; P; PH; PR
  - `Started` integer, nullable: Number of games started in the season
  - `BattingOrder` integer, nullable: This field is expected to be NULL
  - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
  - `AverageDraftPosition` number, nullable: The auction value for this player as it pertains to auction-style drafts for season-long fantasy baseball
  - `AuctionValue` integer, nullable: The auction value for this player as it pertains to auction-style drafts for season-long fantasy baseball
  - `Updated` string, nullable: The timestamp of when the record was last updated (US Eastern Time).
  - `Games` integer, nullable: The number of games played.
  - `FantasyPoints` number, nullable: Total fantasy points
  - `AtBats` number, nullable: At bats while hitting
  - `Runs` number, nullable: Total runs scored.
  - `Hits` number, nullable: Total hits
  - `Singles` number, nullable: Total singles
  - `Doubles` number, nullable: Total doubles
  - `Triples` number, nullable: Total triples
  - `HomeRuns` number, nullable: Total home runs
  - `RunsBattedIn` number, nullable: Total runs batted in
  - `BattingAverage` number, nullable: Total batting average
  - `Outs` number, nullable: Total outs
  - `Strikeouts` number, nullable: Total strikeouts
  - `Walks` number, nullable: Total walks
  - `HitByPitch` number, nullable: Total times hit by pitch
  - `Sacrifices` number, nullable: Total sacrifices
  - `SacrificeFlies` number, nullable: Total sacrifice flies
  - `GroundIntoDoublePlay` number, nullable: Total times grounded into double play
  - `StolenBases` number, nullable: Total stolen bases
  - `CaughtStealing` number, nullable: Total caught stealing
  - `PitchesSeen` number, nullable: Total pitches seen
  - `OnBasePercentage` number, nullable: Total on base percentage
  - `SluggingPercentage` number, nullable: Total slugging percentage
  - `OnBasePlusSlugging` number, nullable: Total on base plus percentage
  - `Errors` number, nullable: Total errors
  - `Wins` number, nullable: Total wins by the team/player
  - `Losses` number, nullable: Total losses by the team/player
  - `Saves` number, nullable: Total saves by team/player
  - `InningsPitchedDecimal` number, nullable: Decimal representation of total innings pitched (e.g. 1.33, 7.66, etc)
  - `TotalOutsPitched` number, nullable: Total outs pitched by team/player
  - `InningsPitchedFull` number, nullable: Total full innings pitched (e.g. 6, 71, 89, etc)
  - `InningsPitchedOuts` number, nullable: Outs pitched beyond InningsPitchedFull (possible values: 0, 1, 2)
  - `EarnedRunAverage` number, nullable: Total earned run average by team/player
  - `PitchingHits` number, nullable: Hits allowed while pitching
  - `PitchingRuns` number, nullable: Runs allowed while pitching
  - `PitchingEarnedRuns` number, nullable: Earned runs allowed while pitching
  - `PitchingWalks` number, nullable: Walks allowed while pitching
  - `PitchingStrikeouts` number, nullable: Strikeouts allowed while pitching
  - `PitchingHomeRuns` number, nullable: Home runs allowed while pitching
  - `PitchesThrown` number, nullable: Total pitches thrown while pitching
  - `PitchesThrownStrikes` number, nullable: Total pitches thrown for strikes while pitching
  - `WalksHitsPerInningsPitched` number, nullable: Walks plus hits per innings pitched (WHIP) while pitching
  - `PitchingBattingAverageAgainst` number, nullable: Total batting average against (BAA) while pitching
  - `GrandSlams` number, nullable: Total grand slams
  - `FantasyPointsFanDuel` number, nullable: Total FanDuel fantasy points
  - `FantasyPointsDraftKings` number, nullable: Total DraftKings fantasy points
  - `FantasyPointsYahoo` number, nullable: Total Yahoo fantasy points
  - `PlateAppearances` number, nullable: Total plate appearances
  - `TotalBases` number, nullable: Number of total bases
  - `FlyOuts` number, nullable: Total fly outs
  - `GroundOuts` number, nullable: Total ground outs
  - `LineOuts` number, nullable: Total line outs
  - `PopOuts` number, nullable: Total pop outs
  - `IntentionalWalks` number, nullable: Total intentional walks
  - `ReachedOnError` number, nullable: Total times reached on error
  - `BallsInPlay` number, nullable: Total balls in play
  - `BattingAverageOnBallsInPlay` number, nullable: Total batting average on balls in play (BABIP)
  - `WeightedOnBasePercentage` number, nullable: Total weight on base percentage
  - `PitchingSingles` number, nullable: Total singles allowed while pitching
  - `PitchingDoubles` number, nullable: Total doubles allowed while pitching
  - `PitchingTriples` number, nullable: Total triples allowed while pitching
  - `PitchingGrandSlams` number, nullable: Total grand slams allowed while pitching
  - `PitchingHitByPitch` number, nullable: Total batters hit by pitch while pitching
  - `PitchingSacrifices` number, nullable: Total sacrifices while pitching
  - `PitchingSacrificeFlies` number, nullable: Total sacrifice flies while pitching
  - `PitchingGroundIntoDoublePlay` number, nullable: Total grounded into double plays while pitching
  - `PitchingCompleteGames` number, nullable: Total complete games while pitching
  - `PitchingShutOuts` number, nullable: Total shuouts while pitching
  - `PitchingNoHitters` number, nullable: Total no hitters while pitching
  - `PitchingPerfectGames` number, nullable: Total perfect games while pitching
  - `PitchingPlateAppearances` number, nullable: Total plate appearances while pitching
  - `PitchingTotalBases` number, nullable: Total bases while pitching
  - `PitchingFlyOuts` number, nullable: Total fly outs while pitching
  - `PitchingGroundOuts` number, nullable: Total ground outs while pitching
  - `PitchingLineOuts` number, nullable: Total line outs while pitching
  - `PitchingPopOuts` number, nullable: Total pop outs while pitching
  - `PitchingIntentionalWalks` number, nullable: Total intentional walks while pitching
  - `PitchingReachedOnError` number, nullable: Total times reached on error while pitching
  - `PitchingCatchersInterference` number, nullable: Total catchers interference while pitching
  - `PitchingBallsInPlay` number, nullable: Total balls in play while pitching
  - `PitchingOnBasePercentage` number, nullable: Total on base percentage (OBP) while pitching
  - `PitchingSluggingPercentage` number, nullable: Total slugging percentage (SLG) while pitching
  - `PitchingOnBasePlusSlugging` number, nullable: Total on base plus slugging (OPS) while pitching
  - `PitchingStrikeoutsPerNineInnings` number, nullable: Total strikeouts per nine innings (K/9) while pitching
  - `PitchingWalksPerNineInnings` number, nullable: Total walks per nine innings (BB/9) while pitching
  - `PitchingBattingAverageOnBallsInPlay` number, nullable: Total batting average on balls in play (BABIP) while pitching
  - `PitchingWeightedOnBasePercentage` number, nullable: Total weighted on base percentage while pitching
  - `DoublePlays` number, nullable: Total double plays, defined as one of: Bunted into Double Play, Fly into Double Play, Fouled into Double Play, Ground into Double Pla,y Line into Double Play, Popped into Double Play
  - `PitchingDoublePlays` number, nullable: Total double plays while pitching
  - `BattingOrderConfirmed` boolean, nullable: Whether the batting order is confirmed (true/false)
  - `IsolatedPower` number, nullable: Total isolated power (ISO)
  - `FieldingIndependentPitching` number, nullable: Total fielding independent pitching (FIP)
  - `PitchingQualityStarts` number, nullable: Total quality starts pitched
  - `PitchingInningStarted` integer, nullable: The inning that the pitcher entered the game (if any).
  - `LeftOnBase` number, nullable: Total left on base percentage
  - `PitchingHolds` number, nullable: Total holds pitched
  - `PitchingBlownSaves` number, nullable: Total blown saves pitched
  - `SubstituteBattingOrder` integer, nullable: The position in the batting order where this player was substituted into the game (does not include players in the starting lineup)
  - `SubstituteBattingOrderSequence` integer, nullable: The sequence in which this player was substituted into the game, within the particular batting order
  - `FantasyPointsFantasyDraft` number, nullable: Total FantasyDraft fantasy points
  - `FantasyPointsBatting` number, nullable: Total batting fantasy points
  - `FantasyPointsPitching` number, nullable: Total pitching fantasy points

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/mlb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/mlb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/mlb-api/revisions/60fb38ac37e7?raw)