MLB Stats API Docs

Type to search endpoints by name, path, or keyword.

GET/api/v1/people/freeAgents

Free agents

Free agents for a season.

On this page

Try it

Query
https://statsapi.mlb.com/api/v1/people/freeAgents?season=2026
const res = await fetch('https://statsapi.mlb.com/api/v1/people/freeAgents?season=2026')
const data = await res.json()
curl -s 'https://statsapi.mlb.com/api/v1/people/freeAgents?season=2026'

Reference

Query parameters

NameTypeRequiredDescription
seasonnumberno

Four-digit year.

Response

Type: FreeAgentsResponse

/** `GET /api/v1/people/freeAgents` */
export interface FreeAgentsResponse extends WithCopyright {
	freeAgents: FreeAgent[]
	season: string
}

Build with it

Live examples powered by this endpoint with real data. Inspiration — restyle and remix freely.

Free-agent board

This season’s free agents with headshots and former teams.

Loading free agents…

Example URLs

  • Free agents (2026): https://statsapi.mlb.com/api/v1/people/freeAgents?season=2026