Skip to main content

NBA Team Rosters API Documentation

Requirement

You need an API key to use SportsBlaze. Get access at www.sportsblaze.com.

Update Frequency

This endpoint updates every 60 minutes.

Description​

This endpoint returns NBA team rosters.

API Endpoint​

https://api.sportsblaze.com/nba/v1/rosters/{season}.json

Parameters​

key (required)​

Your SportsBlaze API key.

team​

The team(s) id or name (e.g. fa62a1a5-2e7d-541f-8e96-e52b64f25a07 or Los Angeles Lakers). Separate multiple teams with a comma (e.g. Los Angeles Lakers,Boston Celtics).

id​

The player(s) id (e.g. 9e80524f-166d-5883-90f5-5eb81f39668c). Separate multiple ids with a comma (e.g. 9e80524f-166d-5883-90f5-5eb81f39668c,a79aa08e-9607-59c9-8c44-5813965df31d).

name​

The player(s) name (e.g. LeBron James). Separate multiple names with a comma (e.g. LeBron James,Luka Dončić).

position​

The player(s) position (e.g. F). Separate multiple positions with a comma (e.g. F,F-G).

Example URLs​

2024 team rosters:

https://api.sportsblaze.com/nba/v1/rosters/2024.json?key=your_key

2024 team rosters, Los Angeles Lakers team:

https://api.sportsblaze.com/nba/v1/rosters/2024.json?key=your_key&team=Los%20Angeles%20Lakers

2024 team rosters, Los Angeles Lakers & Washington Wizards teams, G & F positions:

https://api.sportsblaze.com/nba/v1/rosters/2024.json?key=your_key&team=Los%20Angeles%20Lakers,Washington%20Wizards&position=G,F

Example Response​

{
    "league": {
        "id": "nba",
        "name": "NBA",
        "sport": "Basketball"
    },
    "season": {
        "year": 2024
    },
    "teams": [
        {
            "id": "fa62a1a5-2e7d-541f-8e96-e52b64f25a07",
            "name": "Los Angeles Lakers",
            "roster": [
                {
                    "id": "9e80524f-166d-5883-90f5-5eb81f39668c",
                    "name": "LeBron James",
                    "first": "LeBron",
                    "last": "James",
                    "position": "F",
                    "number": "23",
                    "birthdate": "1984-12-30",
                    "age": 40,
                    "height": 81,
                    "weight": 250,
                    "headshot": "https://cdn.nba.com/headshots/nba/latest/1040x760/2544.png"
                },
                {
                    "id": "a79aa08e-9607-59c9-8c44-5813965df31d",
                    "name": "Luka Dončić",
                    "first": "Luka",
                    "last": "Dončić",
                    "position": "F-G",
                    "number": "77",
                    "birthdate": "1999-02-28",
                    "age": 26,
                    "height": 78,
                    "weight": 230,
                    "headshot": "https://cdn.nba.com/headshots/nba/latest/1040x760/1629029.png"
                }
            ]
        }
    ],
    "updated": "2025-04-11T18:00:35Z"
}