get https://api.sportradar.com/mlb//v8//league/free_agents.
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 seasonPRE(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 playerC(Catcher), IF(Infield), OF(Outfield), P(Pitcher), DH(Designated Hitter) |
status | free_agent | String | Status of a playerA(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. |