Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Team Depth Chart

MLB Team Depth Chart provides current depth chart for all positions on a given team.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 4 hours

Data Updates: Depth charts may update multiple times per week to remain current

📘

Building Team Rosters

Learn how to use team depth chart data for position-ordered roster displays in our Building Team Rosters integration scenario.


Data Points

Player
AttributeParent ElementTypeDescription
descpositionStringText description of a position

ex. Left Field
namepositionStringAbbreviated description of a position

ex. LF
depthplayerIntegerPlayer's depth chart position (1 = starter)
first_nameplayerStringFirst name of a player

ex. Markus
full_nameplayerStringFull name of a player

ex. Mookie Betts
suffixplayerStringName suffix of a player

ex. Jr.
idplayerGUIDUnique ID of a player

ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a runner

ex. Betts
positionplayerStringPosition of a player

C (Catcher), IF (Infield), OF (Outfield), P (Pitcher), DH (Designated Hitter)
preferred_nameplayerStringPreferred name of a player

ex. Mookie
primary_positionplayerStringPrimary position of a player

C (Catcher), 1B (First Base), 2B (Second Base), 3B (Third Base), SS (Shortstop), LF (Left Field), CF (Centerfield), P (Pitcher), RF (Right Field), RP (Relief Pitcher), SP (Starting Pitcher), DH (Designated Hitter)
statusplayerStringStatus of a player

A (Activated), BRV (Bereavement Leave), D7 (7-Day Injured List), D10 (10-Day Injured List), D15 (15-Day Injured List), D60 (60-Day Injured List), DFA (Designated for assignment), FA (Free agent), FME (Family Medical Emergency), LV (Paid Leave), MIN (Minors), NRI (Non-roster Invite), PL (Paternity Leave), RST (Restricted), RET (Retired), SUS (Suspended), UDP (Unsigned Draft Pick), WV (Waivers), DUP (Duplicate Profile), Null(Blank) (Traded or not activated)

Traded players temporarily have no status listed after they are traded to a new team and are either activated by the MLB club or assigned to a minor league affiliate
Team
AttributeParent ElementTypeDescription
abbrteamStringAbbreviation of a team

ex. TB (Tampa Bay)
idteamGUIDUnique ID of a team

ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team

ex. Tampa Bay
nameteamStringTeam name

ex. Rays

Path Params
string
enum
required
Defaults to trial

The access level of your API key

production (Production), trial (Trial),
tracking (Statcast Production), trial-tracking (Statcast Trial)

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
required
Defaults to 25507be1-6a68-4267-bd82-e097d94b359b

Unique Id of a team, found in the Teams endpoint

Example: 25507be1-6a68-4267-bd82-e097d94b359b

Note: This endpoint is designed for team_ids which exist in the current League Hierarchy endpoint

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json