---
title: "List teams"
method: GET
path: "/api/teams"
tags: ["Teams"]
---

# List teams

`GET /api/teams`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/teams`
- Auth: HTTP bearer

List teams with enriched stats, or look up one team with ?slug=. Archived slugs 404 regardless of casing. Payload includes fans, totalPoints, rank, lastWinner, isOfficial, league, themeColor, leaderboardId, leagueInfo, leagueColors, never-null sport, plus _count { packs, collectibles }. logo is the raster crest (logoPng when the stored logo is SVG, else logo); logoSvg carries the stored vector logo when a logoPng sibling exists, else null. Joinability: joinable (boolean), isGlobal (boolean), teamCategory (e.g. dsports_official). D-Sports is joinable:false / isGlobal:true / teamCategory:"dsports_official" — not a club membership board. source (dsports = partner club with the full social surface; provider = pulled data-only HQ) and providerId (api-sports team id, the dedupe key) are included per team. rosterVerifiedByClubAt is an ISO-8601 timestamp or null (null until a club admin confirms the roster). nickname is the admin-set short club name (for example Milano for Milano HC), or null when unset; clients then derive the short name from name. ?leagueId= filters, ?search= matches name/slug server-side, ?limit=/?page= paginate (opt-in; omitted returns the whole filtered list with { teams, season, total }).

## Query parameters

- `slug` string
- `leagueId` string
- `search` string
- `limit` integer
- `page` integer

## Response `200`

{ success, data: { teams, season, total } } (total always present when filtering/paginating; absent on the unfiltered full-list call) or { success, data: { team } } when slug is set

## Changes

- **2026-09-12** `a8df6fe04343`: 4 info
  - added the new optional `query` request parameter `leagueId`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `search`
- **2026-08-17** `6a5e2c1b8022`: 1 info
  - added the new optional `query` request parameter `slug`
- **2026-03-08** `120afc4ee72c`: 1 breaking, 2 info
  - removed the media type `application/json` for the response with the status `200`
  - the endpoint scheme security `bearerAuth` was added to the API
  - api tag `Teams` added
- **2026-03-08** `ca10899d061e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/teams/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
