Global Baseball API – Lineups Endpoints
July 23rd, 2026
We've released two Lineups endpoints in our Global Baseball API.
The Sport Event Lineups endpoint provides the starting lineups for a given game, while the Season Lineups endpoint provides starting lineups across all games in a given season. Supported leagues are MLB, NPB (Nippon Professional Baseball), and KBO (KBO League).
Two new data points are included: starter and order.
starter: trueindicates a player is in the starting lineup. The starting pitcher hasstarter: trueand noorder.orderdefines the player's spot in the batting order (1–9). This field is also present for substitutes — pinch hitters, pinch runners, and other replacements are assigned theorderof the player they replace. As a result, the sameordervalue may appear on more than one player.
Use starter to determine the starting lineup rather than the presence of order.
⭐ Benefit
Use the new Lineups endpoints to compile a more complete boxscore for your application, including starting lineups, starting pitchers, and batting order for top leagues.
📋 Recommended Actions
- Call the Sport Event Lineups endpoint with a
sport_event_idto retrieve starting lineups, batting order, and starting pitchers for an individual game. - Use the Season Lineups endpoint to retrieve lineup data across a full season for supported leagues.
- Key off the
starterfield rather than the presence oforderwhen determining who is in the starting lineup, since substitutes inherit theorderof the player they replace. - Confirm your application handles the supported leagues (MLB, NPB, KBO) and accounts for lineups that may not yet be posted before a game begins.
☑️ Sample Request:
Sport Event Lineups
curl --request GET \
--url https://api.sportradar.com/baseball/trial/v2/en/sport_events/sr:sport_event:63299309/lineups.json \
--header 'accept: application/json' \
--header 'x-api-key: YOUR_API_KEY'🔢 Products
| Sport | Product | Version(s) |
|---|---|---|
| Baseball | Global Baseball API | v2 |
🔁 Endpoints Affected
⚙️ Return Samples
{
"id": "sr:competitor:3638",
"name": "Los Angeles Dodgers",
"country": "United States",
"country_code": "USA",
"abbreviation": "LOS",
"qualifier": "away",
"players": [
{
"id": "sr:player:2294851",
"name": "Sheehan, Emmet",
"type": "P",
"date_of_birth": "1999-11-15",
"nationality": "United states",
"country_code": "USA",
"height": 196,
"weight": 100,
"jersey_number": 80,
"starter": true
},
{
"id": "sr:player:2047729",
"name": "Knack, Landon",
"type": "P",
"date_of_birth": "1997-07-15",
"nationality": "United states",
"country_code": "USA",
"height": 188,
"weight": 100,
"jersey_number": 96
},
{
"id": "sr:player:1990245",
"name": "Vesia, Alex",
"type": "P",
"date_of_birth": "1996-04-11",
"nationality": "United states",
"country_code": "USA",
"height": 185,
"weight": 95,
"jersey_number": 51
},
{
"id": "sr:player:2373075",
"name": "Rushing, Dalton",
"type": "C",
"date_of_birth": "2001-02-21",
"nationality": "United states",
"country_code": "USA",
"height": 185,
"weight": 100,
"jersey_number": 68,
"starter": true,
"order": 9
},
{
"id": "sr:player:1990023",
"name": "Alfonzo, Eliezer",
"type": "C",
"date_of_birth": "1999-09-23",
"nationality": "Venezuela",
"country_code": "VEN",
"height": 178,
"weight": 70,
"jersey_number": 64,
"order": 4
},
{
"id": "sr:player:841793",
"name": "Freeman, Freddie",
"type": "IF",
"date_of_birth": "1989-09-12",
"nationality": "United states",
"country_code": "USA",
"height": 196,
"weight": 100,
"jersey_number": 5,
"starter": true,
"order": 4
},
{
"id": "sr:player:853544",
"name": "Rojas, Miguel",
"type": "IF",
"date_of_birth": "1989-02-24",
"nationality": "Venezuela",
"country_code": "VEN",
"height": 183,
"weight": 85,
"jersey_number": 72,
"starter": true,
"order": 6
},
{
"id": "sr:player:1410115",
"name": "Edman, Tommy",
"type": "IF",
"date_of_birth": "1995-05-09",
"nationality": "United states",
"country_code": "USA",
"height": 178,
"weight": 88,
"jersey_number": 25,
"starter": true,
"order": 3
},
{
"id": "sr:player:856712",
"name": "Betts, Mookie",
"type": "IF",
"date_of_birth": "1992-10-07",
"nationality": "United states",
"country_code": "USA",
"height": 178,
"weight": 82,
"jersey_number": 50,
"starter": true,
"order": 5
},
{
"id": "sr:player:861864",
"name": "Hernandez, Teoscar",
"type": "OF",
"date_of_birth": "1992-10-15",
"nationality": "Dominican republic",
"country_code": "DOM",
"height": 188,
"weight": 98,
"jersey_number": 37,
"starter": true,
"order": 7
},
{
"id": "sr:player:2009139",
"name": "Pages, Andy",
"type": "OF",
"date_of_birth": "2000-12-08",
"nationality": "Cuba",
"country_code": "CUB",
"height": 185,
"weight": 96,
"jersey_number": 44,
"starter": true,
"order": 2
},
{
"id": "sr:player:1085300",
"name": "Call, Alex",
"type": "OF",
"date_of_birth": "1994-09-27",
"nationality": "United states",
"country_code": "USA",
"height": 183,
"weight": 85,
"jersey_number": 12,
"starter": true,
"order": 8
},
{
"id": "sr:player:1373965",
"name": "Ohtani, Shohei",
"type": "P-DH",
"date_of_birth": "1994-07-05",
"nationality": "Japan",
"country_code": "JPN",
"height": 191,
"weight": 95,
"jersey_number": 17,
"starter": true,
"order": 1
},
{
"id": "sr:player:843181",
"name": "Muncy, Max",
"type": "IF",
"date_of_birth": "1990-08-25",
"nationality": "United states",
"country_code": "USA",
"height": 183,
"weight": 98,
"jersey_number": 13,
"order": 8
},
{
"id": "sr:player:2407051",
"name": "Freeland, Alex",
"type": "SS",
"date_of_birth": "2001-08-24",
"nationality": "United states",
"country_code": "USA",
"height": 188,
"weight": 91,
"jersey_number": 76,
"order": 6
},
{
"id": "sr:player:2294847",
"name": "Wrobleski, Justin",
"type": "P",
"date_of_birth": "2000-07-14",
"nationality": "United states",
"country_code": "USA",
"height": 185,
"weight": 88,
"jersey_number": 70
},
...<lineups>
<competitors>
<competitor id="sr:competitor:3635" name="Philadelphia Phillies" country="United States" country_code="USA" abbreviation="PHI" qualifier="home">
<players>
<player id="sr:player:2542325" name="Kerkering, Richard" type="RP" date_of_birth="2001-04-04" nationality="United states" country_code="USA" height="188" weight="93" jersey_number="50"/>
<player id="sr:player:2008185" name="Shugart, Chase" type="P" date_of_birth="1996-10-24" nationality="United states" country_code="USA" height="180" weight="91" jersey_number="55"/>
<player id="sr:player:1976601" name="Sanchez, Cristopher" type="P" date_of_birth="1996-12-12" nationality="Dominican republic" country_code="DOM" height="198" weight="91" jersey_number="61" starter="true"/>
<player id="sr:player:1688493" name="Bowlan, Jonathan" type="P" date_of_birth="1996-12-01" nationality="United states" country_code="USA" height="198" weight="108" jersey_number="52"/>
<player id="sr:player:1437528" name="Duran, Jhoan" type="P" date_of_birth="1998-01-08" nationality="Dominican republic" country_code="DOM" height="196" weight="104" jersey_number="59"/>
<player id="sr:player:1079958" name="Alvarado, Jose" type="P" date_of_birth="1995-05-21" nationality="Venezuela" country_code="VEN" height="188" weight="111" jersey_number="46"/>
<player id="sr:player:842023" name="Realmuto, J.T." type="C" date_of_birth="1991-03-18" nationality="United states" country_code="USA" height="185" weight="96" jersey_number="10" starter="true" order="7"/>
<player id="sr:player:842865" name="Harper, Bryce" type="IF" date_of_birth="1992-10-16" nationality="United states" country_code="USA" height="191" weight="95" jersey_number="3" starter="true" order="3"/>
<player id="sr:player:1745137" name="Stott, Bryson" type="IF" date_of_birth="1997-10-06" nationality="United states" country_code="USA" height="185" weight="91" jersey_number="5" starter="true" order="6"/>
<player id="sr:player:1483778" name="Bohm, Alec" type="IF" date_of_birth="1996-08-03" nationality="United states" country_code="USA" height="196" weight="99" jersey_number="28" starter="true" order="4"/>
<player id="sr:player:849922" name="Turner, Trea" type="IF" date_of_birth="1993-06-30" nationality="United states" country_code="USA" height="185" weight="84" jersey_number="7" starter="true" order="1"/>
<player id="sr:player:1001297" name="Marsh, Brandon" type="OF" date_of_birth="1997-12-18" nationality="United states" country_code="USA" height="188" weight="98" jersey_number="16" starter="true" order="5"/>
<player id="sr:player:2372919" name="Crawford, Justin" type="OF" date_of_birth="2004-01-13" nationality="United states" country_code="USA" height="191" weight="79" jersey_number="2" starter="true" order="9"/>
<player id="sr:player:2401809" name="Rincones Jr, Gabriel" type="OF" date_of_birth="2001-03-03" nationality="United states" country_code="USA" height="193" weight="102" jersey_number="85" starter="true" order="8"/>
...