Teams & Players
Access team information, rosters, injury reports, player stats, and schedules across all supported leagues.
Teams
GET
/v1/leagues/:leagueId/teamsList all teams in a league.
| Parameter | Type | Required | Description |
|---|---|---|---|
| leagueId | string | Yes | The 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/:teamIdGet detailed information for a single team.
| Parameter | Type | Required | Description |
|---|---|---|---|
| teamId | string | Yes | The unique identifier of the team. |
GET
/v1/teams/:teamId/rosterGet the current roster for a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
| teamId | string | Yes | The 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
| teamId | string | Yes | The 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/statsGet aggregated player stats for a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
| teamId | string | Yes | The unique identifier of the team. |
| season | string | No | Season identifier (e.g. "2025"). Defaults to the current season. |
GET
/v1/teams/:teamId/scheduleGet the upcoming and past schedule for a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
| teamId | string | Yes | The unique identifier of the team. |
Players
GET
/v1/players/:playerIdGet detailed information for a single player.
| Parameter | Type | Required | Description |
|---|---|---|---|
| playerId | string | Yes | The unique identifier of the player. |
GET
/v1/players/:playerId/statsGet stats for a single player.
| Parameter | Type | Required | Description |
|---|---|---|---|
| playerId | string | Yes | The unique identifier of the player. |
| type | string | No | Stat type (e.g. "season", "game", "career"). Defaults to season averages. |
| season | string | No | Season identifier (e.g. "2025"). Defaults to the current season. |