Free Agents

get https://api.sportradar.com/mlb/{access_level}/v8/{language_code}/league/free_agents.{format}

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

⏱️
Update Frequency
TTL / Cache: 300 seconds
Data Updates: Updates are made in realtime as changes are made to rosters or player profiles.

Data Points

League:

Attribute	Parent Element	Type	Description
`id`	`season`	GUID	Unique ID of a season ex. `f5aa580e-8103-4ff5-beb0-965dbe8a8cf1`
`type`	`season`	String	Type of season `PRE` (Spring Training), `REG` (Regular Season), `PST` (Postseason), `AST` (All-Star Game)
`year`	`season`	Integer	Year of a season

Free Agent:

Attribute	Parent Element	Type	Description
`bat_hand`	`free_agent`	String	Handedness of a hitter
`first_name`	`free_agent`	String	First name of a player ex. `Markus`
`full_name`	`free_agent`	String	Full name of a player ex. `Mookie Betts`
`height`	`free_agent`	Integer	Player height in inches
`id`	`free_agent`	GUID	Unique ID of a player ex. `ea1a2111-44cc-4996-babb-9439465e6760`
`last_name`	`free_agent`	String	Last name of a player ex. `Betts`
`mlbam_id`	`free_agent`	Integer	Unique MLBAM ID of a player ex. `477132`
`preferred_name`	`free_agent`	String	Preferred name of a player ex. `Mookie`
`position`	`free_agent`	String	Position of a player `C` (Catcher), `IF` (Infield), `OF` (Outfield), `P` (Pitcher), `DH` (Designated Hitter)
`status`	`free_agent`	String	Status of a player `A` (Activated), `BRV` (Bereavement Leave), `D7` (7-Day Injured List), `D10` (10-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_hand`	`free_agent`	String	Throwing hand of a player ex. `L`, `R`
`weight`	`free_agent`	Integer	Player weight in lbs.

Language

Credentials

Header

Click Try It! to start a request and see the response here!