Teams

Overview

The teams endpoints provide team metadata, player rosters, and season-level statistics. Teams are identified by a normalized teamID that is consistent across sports and seasons. Accounts created on or after 2026-09-07T18:00:00Z follow the new stats-access policy; see Stats Access for effective-access fields and coverage limits.

Endpoints

GET /api/v2/teams/{teamID}/ — Get a team by ID

Returns team details including name, abbreviation, mascot, and sport association.

Path Parameters

Parameter	Description
`teamID`	Normalized team ID (integer)

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/42/"

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" \
  "https://therundown.io/api/v2/teams/42/"

import os
import requests

resp = requests.get(
    "https://therundown.io/api/v2/teams/42/",
    headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]}
)
team = resp.json()
print(f"{team['name']} ({team['abbreviation']})")

const API_KEY = process.env.THERUNDOWN_API_KEY;
if (!API_KEY) throw new Error("Set THERUNDOWN_API_KEY in the Node.js server environment");
const resp = await fetch(
  "https://therundown.io/api/v2/teams/42/",
  { headers: { "X-TheRundown-Key": API_KEY } }
);
const team = await resp.json();
console.log(`${team.name} (${team.abbreviation})`);

Example Response

{
  "team_id": 42,
  "name": "Boston Celtics",
  "abbreviation": "BOS",
  "mascot": "Celtics",
  "sport_id": 4,
  "conference": "Eastern",
  "division": "Atlantic"
}

If you don’t know the team ID, use GET /api/v2/sports/{sportID}/teams to list all teams for a sport and find the ID you need.

GET /api/v2/teams/{teamID}/players — Get team roster

Returns all players currently associated with a team.

Path Parameters

Parameter	Description
`teamID`	Normalized team ID

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/42/players"

import os
import requests

resp = requests.get(
    "https://therundown.io/api/v2/teams/42/players",
    headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]}
)
for player in resp.json()["players"]:
    print(f"{player['name']} - {player['position']}")

const API_KEY = process.env.THERUNDOWN_API_KEY;
if (!API_KEY) throw new Error("Set THERUNDOWN_API_KEY in the Node.js server environment");
const resp = await fetch(
  "https://therundown.io/api/v2/teams/42/players",
  { headers: { "X-TheRundown-Key": API_KEY } }
);
const data = await resp.json();
data.players.forEach(p => console.log(`${p.name} - ${p.position}`));

Example Response

{
  "players": [
    {
      "player_id": 1002,
      "name": "Jayson Tatum",
      "position": "SF",
      "jersey_number": "0",
      "team_id": 42
    },
    {
      "player_id": 1003,
      "name": "Jaylen Brown",
      "position": "SG",
      "jersey_number": "7",
      "team_id": 42
    },
    {
      "player_id": 1004,
      "name": "Derrick White",
      "position": "PG",
      "jersey_number": "9",
      "team_id": 42
    }
  ]
}

GET /api/v2/teams/{teamID}/stats — Get team season stats

Returns aggregate season statistics for a team.

Parameters

Parameter	Type	Required	Description
`teamID`	path	Yes	Normalized team ID
`stats_ids`	query	No	Comma-separated stat IDs to include (max 12). Use `GET /api/v2/stats` to discover available stat IDs.
`year`	query	No	Season year. Defaults to the current season.
`season_type`	query	No	Season type ID. Default `2` (regular season). Use `GET /api/v2/season_types` for options.

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/42/stats"

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/42/stats?stats_ids=1,2,3&year=2025&season_type=2"

import os
import requests

resp = requests.get(
    "https://therundown.io/api/v2/teams/42/stats",
    headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]},
    params={"stats_ids": "1,2,3", "year": 2026}
)
for stat in resp.json()[0]["stats"]:
    print(f"{stat['name']}: {stat['value']}")

const API_KEY = process.env.THERUNDOWN_API_KEY;
if (!API_KEY) throw new Error("Set THERUNDOWN_API_KEY in the Node.js server environment");
const resp = await fetch(
  "https://therundown.io/api/v2/teams/42/stats?stats_ids=1,2,3&year=2026",
  { headers: { "X-TheRundown-Key": API_KEY } }
);
const data = await resp.json();
data[0].stats.forEach(s => console.log(`${s.name}: ${s.value}`));

A current-season response is the latest published aggregate and can include in-progress activity. The current season follows the sport’s calendar, not the calendar year. Supplying year requests available archive data; odds-history access does not imply stats archive coverage.

Example Response

[
  {
    "team": {
      "team_id": 42,
      "name": "Boston Celtics"
    },
    "season": {
      "year": 2026,
      "season_type": "Regular Season"
    },
    "stats": [
      { "stat_id": 1, "name": "Points Per Game", "value": "118.5" },
      { "stat_id": 2, "name": "Rebounds Per Game", "value": "45.2" },
      { "stat_id": 3, "name": "Assists Per Game", "value": "27.8" }
    ]
  }
]

GET /api/v2/teams/{teamID}/players/stats — Get player season stats for a team

Returns individual player season statistics for all players on a team. Supports filtering by specific players and stat types.

Parameters

Parameter	Type	Required	Description
`teamID`	path	Yes	Normalized team ID
`stats_ids`	query	No	Comma-separated stat IDs (max 12)
`player_ids`	query	No	Comma-separated player IDs to filter
`year`	query	No	Season year. Defaults to current season.
`season_type`	query	No	Season type ID. Default `2` (regular season).

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/42/players/stats"

curl -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/42/players/stats?player_ids=100,101&stats_ids=1,2"

import os
import requests

resp = requests.get(
    "https://therundown.io/api/v2/teams/42/players/stats",
    headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]},
    params={"stats_ids": "1,2,3", "year": 2026}
)

for player_stat in resp.json():
    print(f"{player_stat['player']['name']}: {player_stat['stats']}")

const API_KEY = process.env.THERUNDOWN_API_KEY;
if (!API_KEY) throw new Error("Set THERUNDOWN_API_KEY in the Node.js server environment");
const resp = await fetch(
  "https://therundown.io/api/v2/teams/42/players/stats?stats_ids=1,2,3&year=2026",
  { headers: { "X-TheRundown-Key": API_KEY } }
);
const data = await resp.json();
data.forEach(p => console.log(`${p.player.name}: ${JSON.stringify(p.stats)}`));

Player season results use each player’s current roster association. Do not treat the team filter as guaranteed historical team attribution after a player transfer. For historical game team identity, use the event game-box endpoints instead.

Example Response

[
  {
    "player": {
      "player_id": 1002,
      "name": "Jayson Tatum",
      "position": "SF"
    },
    "team": {
      "team_id": 42,
      "name": "Boston Celtics"
    },
    "season": {
      "year": 2026,
      "season_type": "Regular Season"
    },
    "stats": [
      { "stat_id": 1, "name": "Points Per Game", "value": "27.4" },
      { "stat_id": 2, "name": "Rebounds Per Game", "value": "8.1" }
    ]
  },
  {
    "player": {
      "player_id": 1003,
      "name": "Jaylen Brown",
      "position": "SG"
    },
    "team": {
      "team_id": 42,
      "name": "Boston Celtics"
    },
    "season": {
      "year": 2026,
      "season_type": "Regular Season"
    },
    "stats": [
      { "stat_id": 1, "name": "Points Per Game", "value": "23.8" },
      { "stat_id": 2, "name": "Rebounds Per Game", "value": "5.5" }
    ]
  }
]

V2 Sports

V2 Events

V2 Markets

V2 Futures

V2 Teams

V2 Players

V2 Stats

V2 Reference

V2 WebSocket

V1 Events (Legacy)

V1 Lines (Legacy)

V1 Sports (Legacy)

V1 Delta (Legacy)

V1 Reference (Legacy)

V1 WebSocket (Legacy)

Overview

Endpoints

Path Parameters

Example Response

Path Parameters

Example Response

Parameters

Example Response

Parameters

Example Response

​Overview

​Endpoints

​Path Parameters

​Example Response

​Path Parameters

​Example Response

​Parameters

​Example Response

​Parameters

​Example Response

Overview

Endpoints

Path Parameters

Example Response

Path Parameters

Example Response

Parameters

Example Response

Parameters

Example Response