MLB API - Full Roster Endpoint

We’ve added an expanded Team Roster endpoint to our MLB API. This new RESTful endpoint returns all players associated with a given team, including approximately 100 minor league players who are not on the 40-man roster.

Note that this endpoint does not include every player in a team’s minor league system

Active Status
In conjunction with this endpoint release, we added a roster_status attribute, indicating whether a player is on the 40-man roster.

Attribute Description

player.roster_status Indicates a player is on the 40-man roster when roster_status="active"

player.active Indicates whether a player is on the active roster.

When active="true":
- During the regular season, the player is on the 26-man active roster (28-man roster in September).
- During the offseason and most of Spring Training, the active roster may expand to include up to 40 players.

When active="false", the player is part of the organization (typically in the minor leagues) but is not on the active roster.

Attribute	Description
`player.roster_status`	Indicates a player is on the 40-man roster when `roster_status="active"`
`player.active`	Indicates whether a player is on the active roster. When `active="true"`: - During the regular season, the player is on the 26-man active roster (28-man roster in September). - During the offseason and most of Spring Training, the active roster may expand to include up to 40 players. When `active="false"`, the player is part of the organization (typically in the minor leagues) but is not on the active roster.

⭐ Benefit

Use the Team Full Roster endpoint to:

Build a more complete team database, with callouts for players on 26-man, 40-man, and minor league rosters
Create player profiles for star minor leaguers prior to their call-up to the majors
Directly and easily identify minor leaguer affiliations in one request, instead of parsing past contests

☑️ Sample Request:

Team Full Roster - https://api.sportradar.com/teams/{team_id}/full_roster.json

🔢 Versions

MLB v8 API

🔁 Endpoints Affected

Team Full Roster

⚙️ Return Samples

    <players>
        <player id="ff977ade-b636-4c8b-b19d-04145d3c828a" status="MIN" position="P" primary_position="SP" first_name="Jonathan" last_name="Santucci" preferred_name="Jonathan" full_name="Jonathan Santucci" height="74" weight="205" throw_hand="L" bat_hand="L" college="Duke" high_school="Phillips Academy (MA)" birthdate="2002-12-28" birthstate="MA" birthcountry="USA" birthcity="Leominster" updated="2024-07-21T00:06:50+00:00" reference="695558" active="false"/>
        <player id="fb9a7c35-18d2-4cd4-a38f-7d1053424d31" status="MIN" position="IF" primary_position="3B" first_name="Yonny" last_name="Hernández" preferred_name="Yonny" full_name="Yonny Hernández" height="68" weight="140" throw_hand="R" bat_hand="B" birthdate="1998-05-04" birthcountry="VEN" birthcity="Maturin" pro_debut="2021-08-05" updated="2025-09-30T16:16:32+00:00" rookie_year="2021" reference="660634" active="false"/>
        <player id="fb54c478-adb3-4e94-861b-b86dc1339917" status="MIN" position="P" primary_position="SP" first_name="Zachary" last_name="Peek" preferred_name="Zach" full_name="Zach Peek" height="75" weight="190" throw_hand="R" bat_hand="R" college="Winthrop" high_school="Jefferson Forest (VA)" birthdate="1998-05-06" birthstate="VA" birthcountry="USA" birthcity="Pineville" updated="2025-12-19T03:23:17+00:00" reference="686745" active="false"/>
        <player id="faf37368-c395-4024-9a5d-40f7a15e2d86" status="MIN" position="OF" primary_position="CF" first_name="José" last_name="Ramos" preferred_name="José" jersey_number="99" full_name="José Ramos" height="72" weight="200" throw_hand="R" bat_hand="R" birthdate="2001-01-01" birthcountry="PAN" birthcity="Chepo" updated="2026-01-14T14:46:20+00:00" reference="682947" active="false"/>
        <player id="fa5caff9-4291-4cbf-ab6b-374dc583a57f" status="A" position="OF" primary_position="LF" first_name="Jared" last_name="Young" preferred_name="Jared" jersey_number="29" full_name="Jared Young" height="74" weight="200" throw_hand="R" bat_hand="L" college="Old Dominion" high_school="Kelowna (CAN)" birthdate="1995-07-09" birthstate="BC" birthcountry="CAN" birthcity="Prince George" pro_debut="2022-09-16" updated="2026-01-22T05:17:34+00:00" salary="820000" rookie_year="2023" reference="676724" active="true" roster_status="active"/>

    "players":
    [
        {
            "id": "ff977ade-b636-4c8b-b19d-04145d3c828a",
            "status": "MIN",
            "position": "P",
            "primary_position": "SP",
            "first_name": "Jonathan",
            "last_name": "Santucci",
            "preferred_name": "Jonathan",
            "full_name": "Jonathan Santucci",
            "height": "74",
            "weight": "205",
            "throw_hand": "L",
            "bat_hand": "L",
            "college": "Duke",
            "high_school": "Phillips Academy (MA)",
            "birthdate": "2002-12-28",
            "birthstate": "MA",
            "birthcountry": "USA",
            "birthcity": "Leominster",
            "updated": "2024-07-21T00:06:50+00:00",
            "reference": "695558",
            "active": false
        },
        {
            "id": "fb9a7c35-18d2-4cd4-a38f-7d1053424d31",
            "status": "MIN",
            "position": "IF",
            "primary_position": "3B",
            "first_name": "Yonny",
            "last_name": "Hernández",
            "preferred_name": "Yonny",
            "full_name": "Yonny Hernández",
            "height": "68",
            "weight": "140",
            "throw_hand": "R",
            "bat_hand": "B",
            "birthdate": "1998-05-04",
            "birthcountry": "VEN",
            "birthcity": "Maturin",
            "pro_debut": "2021-08-05",
            "updated": "2025-09-30T16:16:32+00:00",
            "rookie_year": 2021,
            "reference": "660634",
            "active": false
        },
        {
            "id": "fb54c478-adb3-4e94-861b-b86dc1339917",
            "status": "MIN",
            "position": "P",
            "primary_position": "SP",
            "first_name": "Zachary",
            "last_name": "Peek",
            "preferred_name": "Zach",
            "full_name": "Zach Peek",
            "height": "75",
            "weight": "190",
            "throw_hand": "R",
            "bat_hand": "R",
            "college": "Winthrop",
            "high_school": "Jefferson Forest (VA)",
            "birthdate": "1998-05-06",
            "birthstate": "VA",
            "birthcountry": "USA",
            "birthcity": "Pineville",
            "updated": "2025-12-19T03:23:17+00:00",
            "reference": "686745",
            "active": false
        },
        {
            "id": "faf37368-c395-4024-9a5d-40f7a15e2d86",
            "status": "MIN",
            "position": "OF",
            "primary_position": "CF",
            "first_name": "José",
            "last_name": "Ramos",
            "preferred_name": "José",
            "jersey_number": "99",
            "full_name": "José Ramos",
            "height": "72",
            "weight": "200",
            "throw_hand": "R",
            "bat_hand": "R",
            "birthdate": "2001-01-01",
            "birthcountry": "PAN",
            "birthcity": "Chepo",
            "updated": "2026-01-14T14:46:20+00:00",
            "reference": "682947",
            "active": false
        },
        {
            "id": "fa5caff9-4291-4cbf-ab6b-374dc583a57f",
            "status": "A",
            "position": "OF",
            "primary_position": "LF",
            "first_name": "Jared",
            "last_name": "Young",
            "preferred_name": "Jared",
            "jersey_number": "29",
            "full_name": "Jared Young",
            "height": "74",
            "weight": "200",
            "throw_hand": "R",
            "bat_hand": "L",
            "college": "Old Dominion",
            "high_school": "Kelowna (CAN)",
            "birthdate": "1995-07-09",
            "birthstate": "BC",
            "birthcountry": "CAN",
            "birthcity": "Prince George",
            "pro_debut": "2022-09-16",
            "updated": "2026-01-22T05:17:34+00:00",
            "salary": 820000,
            "rookie_year": 2023,
            "reference": "676724",
            "active": true,
            "roster_status": "active"
        },
        {
            "id": "f809731c-1823-403b-afc4-116e37cebd25",
            "status": "NRI",
            "position": "IF",
            "primary_position": "SS",
            "first_name": "Jackson",
            "last_name": "Cluff",
            "preferred_name": "Jackson",
            "full_name": "Jackson Cluff",
            "height": "71",
            "weight": "181",
            "throw_hand": "R",
            "bat_hand": "L",
            "college": "BYU",
            "high_school": "Rocky Mountain (ID)",
            "birthdate": "1996-12-03",
            "birthstate": "CO",
            "birthcountry": "USA",
            "birthcity": "Littleton",
            "updated": "2025-11-14T20:10:42+00:00",
            "reference": "687714",
            "active": false
        },
        {
            "id": "f65d4c59-5a4b-4711-b3ad-491e07661e16",
            "status": "MIN",
            "position": "C",
            "primary_position": "C",
            "first_name": "Daiverson",
            "last_name": "Gutierrez",
            "preferred_name": "Daiverson",
            "full_name": "Daiverson Gutierrez",
            "height": "71",
            "weight": "206",
            "throw_hand": "R",
            "bat_hand": "R",
            "birthdate": "2005-09-11",
            "birthcountry": "VEN",
            "birthcity": "Caracas",
            "updated": "2025-02-18T22:37:38+00:00",
            "reference": "806987",
            "active": false
        },
        {
            "id": "f5c15cc4-91e4-4303-afc0-db85d143c92b",
            "status": "MIN",
            "position": "OF",
            "primary_position": "LF",
            "first_name": "Estarling",
            "last_name": "Mercado",
            "preferred_name": "Estarling",
            "full_name": "Estarling Mercado",
            "height": "72",
            "weight": "195",
            "throw_hand": "R",
            "bat_hand": "L",
            "birthdate": "2003-03-06",
            "birthcountry": "DOM",
            "birthcity": "San Ignacio de Sabaneta",
            "updated": "2025-03-13T13:30:47+00:00",
            "reference": "807759",
            "active": false
        },
        {
            "id": "f578d526-6d2e-4590-9665-ed42c72c883f",
            "status": "A",
            "position": "P",
            "primary_position": "SP",
            "first_name": "Sean",
            "last_name": "Manaea",
            "preferred_name": "Sean",
            "jersey_number": "59",
            "full_name": "Sean Manaea",
            "height": "77",
            "weight": "245",
            "throw_hand": "L",
            "bat_hand": "R",
            "college": "Indiana State",
            "high_school": "Andrean (IN)",
            "birthdate": "1992-02-01",
            "birthstate": "IN",
            "birthcountry": "USA",
            "birthcity": "Valparaiso",
            "pro_debut": "2016-04-29",
            "updated": "2026-01-22T05:09:05+00:00",
            "salary": 19680726,
            "rookie_year": 2016,
            "reference": "640455",
            "active": true,
            "roster_status": "active"
        },