GETTING STARTED
GET/api/teams
List teams
Every NBA 2K team with player count and average rating — current, classic, and all-time rosters.
REQUIRES X-API-KEY HEADER · 500 REQ/HR FREE
QUERY PARAMETERS
era
string
curr (default), class, allt — current NBA teams, classic teams, or all-time teams. teamType is a supported alias.GET /API/TEAMS/:TEAMNAME/ROSTER
One team's full roster. :teamName accepts the full team name or its slug — Los Angeles Lakers and los-angeles-lakers both resolve to the same team.
:teamName
path · string
Full name or slug, e.g.
Los Angeles Lakers or los-angeles-lakers.teamType
string · optional
curr, class, or allt to disambiguate franchises that exist in multiple eras.ERAS: CURR = 2024-25 SEASON · CLASS = HISTORIC ROSTERS · ALLT = FRANCHISE GREATS.
curl 'https://api.nba2kapi.com/api/teams?era=curr' \ -H 'X-API-Key: YOUR_KEY' # Roster: slug or full team name both work curl 'https://api.nba2kapi.com/api/teams/\ los-angeles-lakers/roster' \ -H 'X-API-Key: YOUR_KEY'
RESPONSE200 OK
{
"success": true,
"data": [
{
"teamName": "Los Angeles Lakers",
"teamType": "curr",
"playerCount": 17,
"averageRating": 82.4
},
{
"teamName": "Boston Celtics",
"teamType": "curr",
"playerCount": 16,
"averageRating": 81.8
},
…
]
}