Skip to main content

MLB Team Rosters API Documentation

Requirement

You need an API key to use SportsBlaze. Get access at www.sportsblaze.com.

Update Frequency

This endpoint updates every 60 seconds.

Description​

This endpoint returns MLB team rosters.

API Endpoint​

https://api.sportsblaze.com/mlb/v1/rosters/{season}.json

Parameters​

key (required)​

Your SportsBlaze API key.

team​

The team id or name (e.g. 880fde72-3384-517f-a14c-d1034ca670f5 or Los Angeles Dodgers). Separate multiple teams with a comma (e.g. Los Angeles Dodgers,New York Yankees).

id​

The player id (e.g. 7961fd8e-97f6-5640-aa70-2982f21f4bab). Separate multiple ids with a comma (e.g. 7961fd8e-97f6-5640-aa70-2982f21f4bab,03577ddf-64cc-5e81-97e8-c36f2c05a7b0).

name​

The player name (e.g. Shohei Ohtani). Separate multiple names with a comma (e.g. Shohei Ohtani,Mookie Betts).

position​

The player position (e.g. P). Separate multiple positions with a comma (e.g. SS,1B).

Example URLs​

2025 team rosters:

https://api.sportsblaze.com/mlb/v1/rosters/2025.json?key=your_key

2025 team rosters, Los Angeles Dodgers team:

https://api.sportsblaze.com/mlb/v1/rosters/2025.json?key=your_key&team=Los%20Angeles%20Dodgers

2025 team rosters, Los Angeles Dodgers & New York Yankees teams, P & SS positions:

https://api.sportsblaze.com/mlb/v1/rosters/2025.json?key=your_key&team=Los%20Angeles%20Dodgers,New%20York%20Yankees&position=P,SS

Example Response​

{
    "league": {
        "id": "mlb",
        "name": "MLB",
        "sport": "Baseball"
    },
    "season": {
        "year": 2025
    },
    "teams": [
        {
            "id": "880fde72-3384-517f-a14c-d1034ca670f5",
            "name": "Los Angeles Dodgers",
            "roster": [
                {
                    "id": "03577ddf-64cc-5e81-97e8-c36f2c05a7b0",
                    "name": "Mookie Betts",
                    "first": "Mookie",
                    "last": "Betts",
                    "position": "SS",
                    "number": "50",
                    "birthdate": "1992-10-07",
                    "age": 32,
                    "height": 70,
                    "weight": 180,
                    "headshot": "https://img.mlbstatic.com/mlb-photos/image/upload/d_people:generic:headshot:67:current.png/w_426,q_auto:best/v1/people/605141/headshot/67/current"
                },
                {
                    "id": "7961fd8e-97f6-5640-aa70-2982f21f4bab",
                    "name": "Shohei Ohtani",
                    "first": "Shohei",
                    "last": "Ohtani",
                    "position": "TWP",
                    "number": "17",
                    "birthdate": "1994-07-05",
                    "age": 30,
                    "height": 75,
                    "weight": 210,
                    "headshot": "https://img.mlbstatic.com/mlb-photos/image/upload/d_people:generic:headshot:67:current.png/w_426,q_auto:best/v1/people/660271/headshot/67/current"
                }
            ]
        }
    ],
    "updated": "2025-04-21T17:36:01Z"
}