---
title: "NBA Team Leaderboard"
canonical_url: "https://apidocs.sportradar.com/resources/widgets/docs/widgets/nba/team-leaderboard"
markdown_url: "https://apidocs.sportradar.com/resources/widgets/docs/widgets/nba/team-leaderboard.md"
last_updated: "2026-03-26T13:44:48Z"
---

# NBA Team Leaderboard

The **NBA Team Leaderboard** widget displays comprehensive NBA team player statistics across multiple performance categories including Points, Rebounds, Assists, Steals, Blocks, and Field Goal Percentage. The widget presents top-performing players in each statistical category with detailed breakdowns and comparative metrics specific to basketball. It is designed for basketball betting platforms and sports information sites that need to provide detailed NBA team insights to help users analyze player performance and make informed decisions. The widget offers season selection via dropdown, configurable statistical categories through tabs, customizable player limits, and interactive player selection handlers for seamless integration with player profile pages or betting features.

<figure>

![Default View](https://apidocs.sportradar.com/resources/widgets/static/img/nba/team-leaderboard/default_view_carousel.png)

  <figcaption class="text-muted-foreground text-center text-sm">
    <p>Shows the default view of the NBA Team Leaderboard widget.</p>
  </figcaption>

</figure>

See the [NBA Team Leaderboard widget demo](https://widgets.sir.sportradar.com/widgets-demo#matches:\(region:usa,sportId:2,uniqueTournamentId:132\),widget:\(name:team.basketball.leaderboard\)).

## API Reference

### Required Parameters

- **widget-name**: `team.basketball.leaderboard`

The widget requires **teamUid** along with one of the following optional identifiers for season context:

1. **teamUid** (required) - displays current NBA season by default
2. **teamUid** + **seasonId** (optional) - displays specific season
3. **teamUid** + **tournamentId** (optional) - displays specific tournament season

See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md).

**Environment Requirements**

## Technical Requirements:

- JavaScript enabled
- XMLHttpRequest support for data fetching
- CSS3 support for styling and animations

**Supported Sports**

The NBA Team Leaderboard widget supports the following sports:

| Sport      | Sport ID |
| ---------- | -------- |
| Basketball | 2        |

> **Warning**
>
> This widget **only works with NBA**. The widget includes validation that checks if the tournament is NBA and displays an error if used with other leagues: "Only NBA is supported".

| Property              | Type       | Default      | Description                                                                                                                                                                                                                                                                                                  |
| --------------------- | ---------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `teamUid`             | `number`   | **Required** | NBA team unique identifier.<br><br>See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md).                                                                                                                                                        |
| `seasonId`            | `number`   | `undefined`  | Season identifier. When specified, displays statistics for that specific NBA season. If omitted, uses the current NBA season.<br><br>See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md).                                                      |
| `tournamentId`        | `number`   | `undefined`  | Tournament identifier.<br><br>See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md).                                                                                                                                                             |
| `disableWidgetHeader` | `boolean`  | `false`      | When `true`, hides the widget header displaying season name and "Team Leaderboard" title. When `false`, shows the header providing context.                                                                                                                                                                  |
| `limitPlayers`        | `number`   | `undefined`  | Maximum number of players to display in each statistical category. When specified, limits the list to the top N players. If omitted, displays all players with statistics in that category.                                                                                                                  |
| `disableDropdown`     | `boolean`  | `false`      | When `true`, hides the season selection dropdown and displays the current season as static text. When `false`, shows the dropdown allowing users to browse historical seasons. **Note**: Only applicable when `seasonId` or `tournamentId` are not specified.                                                |
| `tabSelected`         | `number`   | `1`          | Specifies which main statistical category tab is initially active. Valid values:<ul><li>`1`: Offensive</li><li>`2`: Defensive</li></ul>                                                                                                                                                                      |
| `subTabSelected`      | `number`   | `1`          | Specifies which sub-category tab is initially active. Valid values: <ul><li>`1`: Points per game (Offensive) / Rebounds per game (Defensive)</li><li>`2`: Assists per game (Offensive) / Steals per game (Defensive)</li><li>`3`: Field goals percentage (Offensive) / Blocks per game (Defensive)</li></ul> |
| `onItemClick`         | `function` | `undefined`  | Event handler callback function triggered when a player row is clicked or touched. Emits `playerId`.                                                                                                                                                                                                         |

## Main Configurable Features

Illustrations of main feature variants with relevant property values below.

**Default View**

Shows the default view of the NBA Team Leaderboard widget.

![Default View](https://apidocs.sportradar.com/resources/widgets/static/img/nba/team-leaderboard/default_view.png)

**Sample Configuration:**

- teamUid: `string|number`

See [NBA Team Leaderboard widget demo](https://widgets.sir.sportradar.com/widgets-demo#matches:\(region:usa,sportId:2,uniqueTournamentId:132\),widget:\(name:team.basketball.leaderboard\))

## Integration Examples

### Property Name Transformations

Properties do not always transfer from the above table directly into integration code. Properties must be transformed differently for each integration method:

#### JavaScript/Programmatic Integration

- Property names remain unchanged in camelCase
- Properties become members of the 4th parameter object in `SIR()` call
- Example: `cardVariant: "compact"`

> **Info**
>
> In javascript integration, the properties go into an object which is passed as the 4th argument of the call ti `SIR()` function. Please see  [Global SIR API](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/SIR.md)

#### HTML/Declarative Integration

- Convert camelCase to lowercase with dashes, e.g. cardVariant becomes card-variant
- Add `data-sr-` prefix
- Example: `cardVariant` → `data-sr-card-variant`
- Example: `filters.sport.hidden` → Complex objects must be passed as JSON strings

> **Info**
>
> In HTML integration, the properties go into the parent HTML object as object properties, prefixed with `data-sr-` as explained above.

> **Only base property support**
>
> This method supports only simple (base) properties and does not support properties that require functions.

> **Info**
>
> In all examples replace `sportradar` in the widgetloader URL path with your clientId.
>
> Example if your clientId is `client1`:
>
> - This URL: `https://widgets.sir.sportradar.com/sportradar/widgetloader`
> - becomes: `https://widgets.sir.sportradar.com/client1/widgetloader`

**Default View**

### JavaScript (Programmatic)

Initialize the widget programmatically using the JavaScript API. The widget renders in the specified container element.

```js
(function(a,b,c,d,e,f,g,h,i){a[e]||(i=a[e]=function(){(a[e].q=a[e].q||[]).push(arguments)},i.l=1*new Date,i.o=f,
g=b.createElement(c),h=b.getElementsByTagName(c)[0],g.async=1,g.src=d,g.setAttribute("n",e),h.parentNode.insertBefore(g,h)
)})(window,document,"script","https://widgets.sir.sportradar.com/sportradar/widgetloader","SIR", {
    language: 'en'
});

SIR('addWidget', '#sr-widget', 'team.basketball.leaderboard', {
    teamUid: 1
});
```

```html
<div id="sr-widget"></div>
```

### HTML (Declarative)

Insert the following HTML code at the target widget location. Complex object properties must be passed as JSON-encoded strings.

```html
<div id="sr-widget"
        data-sr-widget="team.basketball.leaderboard"
        data-sr-team-uid="1">
</div>
<script type="application/javascript"
        src="https://widgets.sir.sportradar.com/sportradar/widgetloader"
        async>
</script>
```
