Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Free Agents

MLB Free Agents provides a list of all current free agents in the league.

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

Update Frequency

TTL / Cache: 4 hours

Data Updates: Updates in realtime as changes are made to rosters or player profiles

📘

Building Team Rosters

Learn how to monitor unsigned players and support off-season roster views in our Building Team Rosters integration scenario.


Data Points

League
AttributeParent ElementTypeDescription
idseasonGUIDUnique ID of a season

ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1
typeseasonStringType of season

PRE (Spring Training), REG (Regular Season), PST (Postseason), AST (All-Star Game)
yearseasonIntegerYear of a season
Free Agent
AttributeParent ElementTypeDescription
bat_handfree_agentStringHandedness of a hitter

L, R, B
first_namefree_agentStringFirst name of a player

ex. Markus
full_namefree_agentStringFull name of a player

ex. Mookie Betts
heightfree_agentIntegerPlayer height in inches
idfree_agentGUIDUnique ID of a player

ex. ea1a2111-44cc-4996-babb-9439465e6760
last_namefree_agentStringLast name of a player

ex. Betts
mlbam_idfree_agentIntegerUnique MLBAM ID of a player

ex. 477132
preferred_namefree_agentStringPreferred name of a player

ex. Mookie
positionfree_agentStringPosition of a player

C (Catcher), IF (Infield), OF (Outfield), P (Pitcher), DH (Designated Hitter)
statusfree_agentStringStatus 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
throw_handfree_agentStringThrowing hand of a player

L, R, B
weightfree_agentIntegerPlayer weight in lbs.

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
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