Teams & Players

Access team information, rosters, injury reports, player stats, and schedules across all supported leagues.

Teams

GET/v1/leagues/:leagueId/teams

List all teams in a league.

ParameterTypeRequiredDescription
leagueIdstringYesThe unique identifier of the league.

Response

{
  "success": true,
  "data": {
    "teams": [
      {
        "teamId": "team_nba_lal",
        "name": "Los Angeles Lakers",
        "abbreviation": "LAL"
      },
      {
        "teamId": "team_nba_bos",
        "name": "Boston Celtics",
        "abbreviation": "BOS"
      }
    ]
  }
}
GET/v1/teams/:teamId

Get detailed information for a single team.

ParameterTypeRequiredDescription
teamIdstringYesThe unique identifier of the team.
GET/v1/teams/:teamId/roster

Get the current roster for a team.

ParameterTypeRequiredDescription
teamIdstringYesThe unique identifier of the team.

Response

{
  "success": true,
  "data": {
    "players": [
      {
        "playerId": "player_lj23",
        "name": "LeBron James",
        "position": "SF",
        "number": 23
      },
      {
        "playerId": "player_ad3",
        "name": "Anthony Davis",
        "position": "PF",
        "number": 3
      }
    ]
  }
}
GET/v1/teams/:teamId/injuriesHobbyist+

Get the latest injury report for a team.

ParameterTypeRequiredDescription
teamIdstringYesThe unique identifier of the team.

Response

{
  "success": true,
  "data": {
    "players": [
      {
        "name": "Anthony Davis",
        "status": "Questionable",
        "injury": "Right knee soreness"
      },
      {
        "name": "Jarred Vanderbilt",
        "status": "Out",
        "injury": "Left foot surgery recovery"
      },
      {
        "name": "Gabe Vincent",
        "status": "Day-to-Day",
        "injury": "Left ankle sprain"
      }
    ]
  }
}
GET/v1/teams/:teamId/stats

Get aggregated player stats for a team.

ParameterTypeRequiredDescription
teamIdstringYesThe unique identifier of the team.
seasonstringNoSeason identifier (e.g. "2025"). Defaults to the current season.
GET/v1/teams/:teamId/schedule

Get the upcoming and past schedule for a team.

ParameterTypeRequiredDescription
teamIdstringYesThe unique identifier of the team.

Players

GET/v1/players/:playerId

Get detailed information for a single player.

ParameterTypeRequiredDescription
playerIdstringYesThe unique identifier of the player.
GET/v1/players/:playerId/stats

Get stats for a single player.

ParameterTypeRequiredDescription
playerIdstringYesThe unique identifier of the player.
typestringNoStat type (e.g. "season", "game", "career"). Defaults to season averages.
seasonstringNoSeason identifier (e.g. "2025"). Defaults to the current season.