Overview
The teams endpoints provide team metadata, player rosters, and season-level statistics. Teams are identified by a normalizedteamID 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
GET /api/v2/teams/{teamID}/ — Get a team by ID
Returns a
teams array with one team: its location name, mascot, abbreviation, current record, and conference and division objects.Path Parameters
| Parameter | Description |
|---|---|
teamID | Normalized team ID (integer) |
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/11/"
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" \
"https://therundown.io/api/v2/teams/11/"
import os
import requests
resp = requests.get(
"https://therundown.io/api/v2/teams/11/",
headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]},
timeout=15
)
resp.raise_for_status()
team = resp.json()["teams"][0]
print(f"{team['name']} {team['mascot']} ({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/11/",
{ headers: { "X-TheRundown-Key": API_KEY } }
);
if (!resp.ok) throw new Error(`Team request failed: HTTP ${resp.status}`);
const { teams: [team] } = await resp.json();
console.log(`${team.name} ${team.mascot} (${team.abbreviation})`);
Example Response
{
"teams": [
{
"team_id": 11,
"name": "Atlanta",
"mascot": "Hawks",
"abbreviation": "ATL",
"record": "5-4",
"conference": {
"conference_id": 39,
"sport_id": 4,
"name": "Eastern Conference"
},
"division": {
"division_id": 17,
"conference_id": 39,
"sport_id": 4,
"name": "Southeast"
}
}
]
}
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
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 --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/11/players"
import os
import requests
resp = requests.get(
"https://therundown.io/api/v2/teams/11/players",
headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]},
timeout=15
)
resp.raise_for_status()
for player in resp.json()["players"]:
print(f"{player['display_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/11/players",
{ headers: { "X-TheRundown-Key": API_KEY } }
);
if (!resp.ok) throw new Error(`Team request failed: HTTP ${resp.status}`);
const data = await resp.json();
data.players.forEach(p => console.log(`${p.display_name} - ${p.position}`));
Example Response
Example truncated to the first two players.{
"players": [
{
"id": 16661,
"sport_id": 4,
"team_id": 11,
"updated_at": "2026-10-15T13:42:53Z",
"first_name": "Aaron",
"last_name": "Wiggins",
"display_name": "Aaron Wiggins",
"weight": 190,
"height": 77,
"display_weight": "190 lbs",
"display_height": "6' 5\"",
"age": 27,
"date_of_birth": "1999-01-02T08:00Z",
"slug": "aaron-wiggins",
"jersey": "2",
"position": "Guard",
"position_abbreviation": "G",
"birth_place_city": "Greensboro",
"birth_place_country": "USA",
"experience_years": 0,
"active": true,
"status": "Active"
},
{
"id": 14673859,
"sport_id": 4,
"team_id": 11,
"updated_at": "2026-10-15T13:42:53Z",
"first_name": "Asa",
"last_name": "Newell",
"display_name": "Asa Newell",
"weight": 224,
"height": 83,
"display_weight": "224 lbs",
"display_height": "6' 11\"",
"age": 21,
"date_of_birth": "2005-10-05T07:00Z",
"slug": "asa-newell",
"jersey": "14",
"position": "Forward",
"position_abbreviation": "F",
"birth_place_city": "Destin",
"birth_place_country": "USA",
"experience_years": 0,
"active": true,
"status": "Active"
}
]
}
GET /api/v2/teams/{teamID}/stats — Get team season stats
GET /api/v2/teams/{teamID}/stats — Get team season stats
Returns aggregate season statistics for a team as an array with one row per stat.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
teamID | path | Yes | Normalized team ID |
stats_ids | query | No | Comma-separated stat IDs to include. Only the first 12 are used; extra entries are ignored. Use GET /api/v2/stats to discover available stat IDs. |
year | query | No | Season year. Defaults to the current season. A non-integer value returns HTTP 400. |
season_type | query | No | Season type ID. Default 2 (regular season). Use GET /api/v2/season_types for options. |
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/11/stats"
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/11/stats?stats_ids=1259,1242,1261&year=2026&season_type=2"
import os
import requests
resp = requests.get(
"https://therundown.io/api/v2/teams/11/stats",
headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]},
params={"stats_ids": "1259,1242,1261", "year": 2026},
timeout=15
)
resp.raise_for_status()
for row in resp.json():
print(f"{row['stat']['display_name']}: {row['display_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/11/stats?stats_ids=1259,1242,1261&year=2026",
{ headers: { "X-TheRundown-Key": API_KEY } }
);
if (!resp.ok) throw new Error(`Team request failed: HTTP ${resp.status}`);
const data = await resp.json();
data.forEach(row => console.log(`${row.stat.display_name}: ${row.display_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_id": 11,
"stat_id": 1242,
"stat": {
"id": 1242,
"name": "avgRebounds",
"category": "general",
"display_name": "Rebounds Per Game",
"abbreviation": "REB",
"description": "The average rebounds per game.",
"sport_id": 4
},
"season_year": 2026,
"season_type": 2,
"season_type_name": "Regular Season",
"value": 43.5366,
"display_value": "43.5",
"updated_at": "2026-10-15T22:36:45.739568Z"
},
{
"team_id": 11,
"stat_id": 1259,
"stat": {
"id": 1259,
"name": "avgPoints",
"category": "offensive",
"display_name": "Points Per Game",
"abbreviation": "PTS",
"description": "The average number of points scored per game.",
"sport_id": 4
},
"season_year": 2026,
"season_type": 2,
"season_type_name": "Regular Season",
"value": 118.4634,
"display_value": "118.5",
"updated_at": "2026-10-15T22:36:45.854304Z"
},
{
"team_id": 11,
"stat_id": 1261,
"stat": {
"id": 1261,
"name": "avgAssists",
"category": "offensive",
"display_name": "Assists Per Game",
"abbreviation": "AST",
"description": "The average assists per game.",
"sport_id": 4
},
"season_year": 2026,
"season_type": 2,
"season_type_name": "Regular Season",
"value": 30.1341,
"display_value": "30.1",
"updated_at": "2026-10-15T22:36:45.875619Z"
}
]
GET /api/v2/teams/{teamID}/players/stats — Get player season stats for a team
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. Only the first 12 are used; extra entries are ignored. Player season stat IDs differ from team season stat IDs; use GET /api/v2/stats to find them |
player_ids | query | No | Comma-separated player IDs to filter. Only the first 6 are used; extra entries are ignored |
year | query | No | Season year. Defaults to current season. A non-integer value returns HTTP 400. |
season_type | query | No | Season type ID. Default 2 (regular season). |
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/11/players/stats"
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/teams/11/players/stats?player_ids=15954,16090&stats_ids=1308,1288"
import os
import requests
resp = requests.get(
"https://therundown.io/api/v2/teams/11/players/stats",
headers={"X-TheRundown-Key": os.environ["THERUNDOWN_API_KEY"]},
params={"stats_ids": "1308,1288,1313", "year": 2026},
timeout=15
)
resp.raise_for_status()
for row in resp.json():
line = ", ".join(f"{s['stat']['abbreviation']} {s['display_value']}" for s in row["stats"])
print(f"{row['player']['display_name']}: {line}")
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/11/players/stats?stats_ids=1308,1288,1313&year=2026",
{ headers: { "X-TheRundown-Key": API_KEY } }
);
if (!resp.ok) throw new Error(`Team request failed: HTTP ${resp.status}`);
const data = await resp.json();
data.forEach(row => console.log(`${row.player.display_name}: ${row.stats.map(s => `${s.stat.abbreviation} ${s.display_value}`).join(", ")}`));
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
Example truncated to one player; the response has one entry per player.[
{
"player": {
"id": 15954,
"sport_id": 4,
"team_id": 11,
"updated_at": "2026-10-15T13:42:53Z",
"first_name": "Onyeka",
"last_name": "Okongwu",
"display_name": "Onyeka Okongwu",
"weight": 240,
"height": 82,
"display_weight": "240 lbs",
"display_height": "6' 10\"",
"age": 25,
"date_of_birth": "2000-12-11T08:00Z",
"slug": "onyeka-okongwu",
"jersey": "17",
"position": "Forward",
"position_abbreviation": "F",
"birth_place_city": "Chino",
"birth_place_country": "USA",
"experience_years": 0,
"active": true,
"status": "Active"
},
"stats": [
{
"player_id": 15954,
"stat_id": 1288,
"stat": {
"id": 1288,
"name": "avgRebounds",
"category": "game",
"display_name": "Rebounds Per Game",
"abbreviation": "REB",
"description": "The average rebounds per game.",
"sport_id": 4
},
"season_year": 2026,
"season_type": 2,
"season_type_name": "Regular Season",
"value": 7.5946,
"display_value": "7.6",
"updated_at": "2026-10-15T22:36:47.953537Z"
},
{
"player_id": 15954,
"stat_id": 1308,
"stat": {
"id": 1308,
"name": "avgPoints",
"category": "game",
"display_name": "Points Per Game",
"abbreviation": "PTS",
"description": "The average number of points scored per game.",
"sport_id": 4
},
"season_year": 2026,
"season_type": 2,
"season_type_name": "Regular Season",
"value": 15.1757,
"display_value": "15.2",
"updated_at": "2026-10-15T22:36:48.061402Z"
},
{
"player_id": 15954,
"stat_id": 1313,
"stat": {
"id": 1313,
"name": "avgAssists",
"category": "game",
"display_name": "Assists Per Game",
"abbreviation": "AST",
"description": "The average assists per game.",
"sport_id": 4
},
"season_year": 2026,
"season_type": 2,
"season_type_name": "Regular Season",
"value": 3.1216,
"display_value": "3.1",
"updated_at": "2026-10-15T22:36:48.079769Z"
}
]
}
]