MLB Stats API Docs

Type to search endpoints by name, path, or keyword.

GET/api/v1/teams/{teamId}/roster

Team roster

Players on a team for a season or roster type.

On this page

Try it

Path
Query
https://statsapi.mlb.com/api/v1/teams/119/roster?rosterType=active&season=2026
const res = await fetch('https://statsapi.mlb.com/api/v1/teams/119/roster?rosterType=active&season=2026')
const data = await res.json()
curl -s 'https://statsapi.mlb.com/api/v1/teams/119/roster?rosterType=active&season=2026'

Reference

Path parameters

NameTypeRequiredDescription
teamIdnumberyes

Team id, e.g. 119 (Los Angeles Dodgers).

Query parameters

NameTypeRequiredDescription
rosterTypeactive40ManfullSeasonfullRosterdepthChartno

Which roster to return. Defaults to active.

seasonnumberno

Four-digit year.

datedateno

Roster as of a specific day, YYYY-MM-DD.

hydratecsvno

e.g. person(stats(type=season)).

fieldscsvno

Comma-separated field paths to keep (trims the response), e.g. roster,person,id,fullName.

Response

Type: RosterResponse

/** Shared roster wrapper for `/roster`, `/coaches`, and `/jobs/{jobType}`. */
export interface RosterResponse extends WithCopyright {
	roster: RosterEntry[]
	link: string
	teamId?: number
	rosterType?: string
}

Build with it

Live examples powered by this endpoint with real data. Inspiration — restyle and remix freely.

Roster grid

Every player with headshot, number, and position in a responsive grid.

Loading live data…

Example URLs

  • Dodgers active roster (2026): https://statsapi.mlb.com/api/v1/teams/119/roster?rosterType=active&season=2026
  • Dodgers 40-man roster: https://statsapi.mlb.com/api/v1/teams/119/roster?rosterType=40Man&season=2026