---
title: "Starting Lineups - by Date"
method: GET
path: "/v3/mlb/projections/{format}/StartingLineupsByDate/{date}"
tags: ["MLB v3 Projections"]
---

# Starting Lineups - by Date

`GET /v3/mlb/projections/{format}/StartingLineupsByDate/{date}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/mlb/projections/{format}/StartingLineupsByDate/{date}`
- 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/projections/:format/StartingLineupsByDate/:date/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns both projected and confirmed starting lineups for all games on a given date.

## Path parameters

- `format` 'JSON' | 'XML', required
- `date` string, required

## Response `200`

Success

- StartingLineups[]
  - `GameID` integer: The unique ID of the game tied to the StartingLineups
  - `Season` integer: The MLB season of the game
  - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar)
  - `Day` string, nullable: The day of the game
  - `DateTime` string, nullable: The date and time of the game in US Eastern Time
  - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled; InProgress; Final; Suspended; Delayed; Postponed; Canceled; Forfeit; NotNecessary
  - `HomeTeamID` integer, nullable: The unique ID of the home team tied to these StartingLineups
  - `HomeTeam` string, nullable: The abbreviation [Key] of the Home Team
  - `AwayTeamID` integer, nullable: The unique TeamID of the away team
  - `AwayTeam` string, nullable: The abbreviation [Key] of the away team
  - `HomeStartingPitcher` Lineup
    - `PlayerID` integer: The player's unique PlayerID as assigned by SportsDataIO Note: this ID will stay with the player throughout their MLB career
    - `TeamID` integer: The team's unique TeamID as assigned by SportsDataIO
    - `Team` string, nullable: The abbreviation [Key] of the team
    - `FirstName` string, nullable: The player's first name
    - `LastName` string, nullable: The player's last name
    - `BattingOrder` integer, nullable: Where the player batted in the lineup for the game (1;2;3; etc.)
    - `Position` string, nullable: Player's position in the starting lineup (if started); otherwise the position he substituted for
    - `Starting` boolean, nullable: Indicates if this player is starting. Note: started = 1 and non starting= 0
    - `Confirmed` boolean, nullable: Indicates if batting order has been confirmed (true/false)
  - `HomeBattingLineup` Lineup[]: The batting lineup of the home team
    - `PlayerID` integer: The player's unique PlayerID as assigned by SportsDataIO Note: this ID will stay with the player throughout their MLB career
    - `TeamID` integer: The team's unique TeamID as assigned by SportsDataIO
    - `Team` string, nullable: The abbreviation [Key] of the team
    - `FirstName` string, nullable: The player's first name
    - `LastName` string, nullable: The player's last name
    - `BattingOrder` integer, nullable: Where the player batted in the lineup for the game (1;2;3; etc.)
    - `Position` string, nullable: Player's position in the starting lineup (if started); otherwise the position he substituted for
    - `Starting` boolean, nullable: Indicates if this player is starting. Note: started = 1 and non starting= 0
    - `Confirmed` boolean, nullable: Indicates if batting order has been confirmed (true/false)
  - `AwayStartingPitcher` Lineup
    - `PlayerID` integer: The player's unique PlayerID as assigned by SportsDataIO Note: this ID will stay with the player throughout their MLB career
    - `TeamID` integer: The team's unique TeamID as assigned by SportsDataIO
    - `Team` string, nullable: The abbreviation [Key] of the team
    - `FirstName` string, nullable: The player's first name
    - `LastName` string, nullable: The player's last name
    - `BattingOrder` integer, nullable: Where the player batted in the lineup for the game (1;2;3; etc.)
    - `Position` string, nullable: Player's position in the starting lineup (if started); otherwise the position he substituted for
    - `Starting` boolean, nullable: Indicates if this player is starting. Note: started = 1 and non starting= 0
    - `Confirmed` boolean, nullable: Indicates if batting order has been confirmed (true/false)
  - `AwayBattingLineup` Lineup[]: Away team batting lineup for the game
    - `PlayerID` integer: The player's unique PlayerID as assigned by SportsDataIO Note: this ID will stay with the player throughout their MLB career
    - `TeamID` integer: The team's unique TeamID as assigned by SportsDataIO
    - `Team` string, nullable: The abbreviation [Key] of the team
    - `FirstName` string, nullable: The player's first name
    - `LastName` string, nullable: The player's last name
    - `BattingOrder` integer, nullable: Where the player batted in the lineup for the game (1;2;3; etc.)
    - `Position` string, nullable: Player's position in the starting lineup (if started); otherwise the position he substituted for
    - `Starting` boolean, nullable: Indicates if this player is starting. Note: started = 1 and non starting= 0
    - `Confirmed` boolean, nullable: Indicates if batting order has been confirmed (true/false)
  - `HomeTeamOpener` boolean, nullable: Indicates whether the home team will use an Opener as the starting pitcher. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game.
  - `AwayTeamOpener` boolean, nullable: Indicates whether the away team will use an Opener as the starting pitcher. NOTE: An opener is a pitcher (typically a relief pitcher) that is only scheduled to pitch the first 1-3 innings of the game.

## 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)