No params required. If called without params, you'll get basic team information.
The "body" of this endpoint returns a LIST of teams
Each team is returned as a map.
Basic team information includes Standings, Team name/city/conference/etc, and links to team logos.
One call returns all teams. teamID or teamAbv is not accepted as a param
Optional Parameters can return each teams' schedule, team stats, top performers, roster, and if you choose roster, you can pull back each player's stats.
This is a powerful endpoint that returns a ton of information back with one call. If called with all parameters active, expect more latency than our average latency.
gameID is always in format awayTeamAbv@homeTeamAbv_gameDate
gameDate is always in format YYYYMMDD
Team abbreviations and Team IDs can be found from /getNBATeams endpoint
Parameters:
No parameters are required. Called by itself will pull back basic team information.
Optional parameters
schedules - If "true", will return an element with a map of schedules called "teamSchedules". If not "true" then it will be ignored.
rosters - If "true", will return an element with a map of players in the current roster called "Roster". If not "true" then it will be ignored.
statsToGet - can be "averages" or "totals". This will return a "stats" element within each player in the roster map. If not "averages" or "totals", then it will be ignored. It will also be ignored if "rosters" is not set to "true". rosters=true is required for "statsToGet" to return anything.
topPerformers - If "true", you will receive an element called "topPerformers" within each team that will give you the top player(s) on that team in each statistical category. If not "true" then it will be ignored.
teamStats - If "true" then you will receive two elements in map format, in each team, called "defensiveStats" and "offensiveStats". These stats are broken down by position. If not "true" then it will be ignored.
Error Handling:
There is no error handling in this endpoint. If the incorrect values are given for a parameter, then those parameters will simply be ignored.
Other Helpful Tips and Info:
Standings information is updated immediately after each game completes.
All stats retrieved are current season only.
Some players will return an empty map for their stats. This will happen if they have not played any games
All player and team stats for this endpoint are accumulated daily. Not real time.
The schedules retrieved do not include game status or win/loss information.
This endpoint will retrieve a map in this format:
statusCode
body - body is a LIST of teams
{}
teamID
teamAbv
teamCity
teamName
wins
loss
currentStreak
result - will either be "W" or "L"
length - length of the streak
ppg - points per game
oppg - opponent points per game
conference
conferenceAbv
division
{logos} - there are links to various different logos you can use
teamSchedule - this will exist if schedules=true
gameID - map for each game. there will be many of these
gameID
seasonType
away - team abbreviation for away team
home - team abbreviation for home team
teamIDAway
teamIDHome
gameDate
gameTime - always in Eastern time
gameTime_epoch
Roster (this is a map of players. key is playerID) - this will exist if rosters=true
playerID (this is a map of player data) - there will be many of these
playerID
teamID
team - this is the team abv
{many other player data elements}
topPerformers (this is a map of the stats that are accumulated for top performers) - this will exist if topPerformers=true
blk
total
playerID - this is a list of all playerIDs who have that total
ast
total
playerID - this is a list of all playerIDs who have that total
tptfgm - (three point field goals made)
total
playerID - this is a list of all playerIDs who have that total
stl
total
playerID - this is a list of all playerIDs who have that total
TOV
total
playerID - this is a list of all playerIDs who have that total
pts
total
playerID - this is a list of all playerIDs who have that total
reb
total
playerID - this is a list of all playerIDs who have that total
defensiveStats - (map) this will exist if teamStats=true
map of different stats, broken up by position
offensiveStats - (map) this will exist if teamStats=true