Person

Search for a player by name

get/api/v1/people/search

Request

  • Base URL: https://statsapi.mlb.com
  • URL: https://statsapi.mlb.com/api/v1/people/search
  • Auth: none declared

Query parameters

namesstring[]

Name a player uses

personIdsinteger[]

Comma delimited list of person ID. Format: 1234, 2345

sportIdsinteger[]

Comma delimited list of top level organizations of a sport

leagueIdsinteger[]

Comma delimited list of Unique league identifiers

teamIdsinteger[]

Comma delimited list of Unique Team identifiers

leagueListId'MILB_FULL' | 'MILB_SHORT' | 'MILB_COMPLEX' | 'MILB_ALL' | 'MILB_ALL_NOMEX' | 'MILB_ALL_DOMESTIC' | 'MILB_NONCOMP' | 'MILB_NONCOMP_NOMEX' | 'MILB_DOMCOMP' | 'MILB_INTCOMP' | 'WIN_NOABL' | 'WIN_CARIBBEAN' | 'WIN_ALL' | 'ABL' | 'MEX_ALL' | 'MLB' | 'MLB_HIST' | 'MLB_MILB' | 'MLB_MILB_HIST' | 'MLB_MILB_WIN' | 'BASEBALL_ALL' | 'MLB_SPRING'

Unique League List Identifier

activeboolean

Whether or not a player is active

verifiedboolean

Complete and confirmed all biographical data

rookieboolean

Whether or not a player is a rookie

seasonsstring[]

Comma delimited list of Seasons of play

fieldsstring[]

Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute

limitinteger

Number of results to return

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.