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