---
title: "List playlists for a game"
method: GET
path: "/games/{id}/playlists"
tags: ["Games"]
---

# List playlists for a game

`GET /games/{id}/playlists`

Returns playlists from the static public game definition for the requested game ID. Playlist IDs are game-scoped, so shared slugs such as standard are not resolved globally.

## Path parameters

- `id` string, required — Static public game ID/slug.

## Response `200`

Public game playlist list.

- ApiGamePlaylistsResponse — Game-scoped playlist response.
  - `game` ApiGameCatalogEntry, required — Static public game catalog entry.
    - `id` string, required — Static public game ID/slug.
    - `convexId` string, nullable, required — Active Convex games-table ID, when available for match APIs.
    - `nameKey` string, required
    - `shortNameKey` string, nullable, required
    - `descriptionKey` string, nullable, required
    - `category` string, required
    - `rulesLink` string, nullable, required
    - `coverImage` string, nullable, required
    - `bannerImage` string, nullable, required
    - `defaultTeamSize` integer, required
    - `hasCompetitiveMode` boolean, required
    - `isComingSoon` boolean, required
    - `isAvailableForMatchApi` boolean, required
    - `modes` ApiGameMode[], required
      - `id` string, required
      - `nameKey` string, required
      - `descriptionKey` string, nullable, required
      - `image` string, nullable, required
      - `shortName` string, nullable, required
      - `rewardBonus` number, nullable, required
      - `supportsDraftToggle` boolean, required
      - `mapIds` string[], required
    - `maps` ApiGameMap[], required
      - `id` string, required
      - `nameKey` string, required
      - `coverImage` string, nullable, required
      - `minimapImage` string, nullable, required
      - `isReleased` boolean, required
    - `playlists` ApiGamePlaylist[], required
      - `id` string, required
      - `nameKey` string, required
      - `descriptionKey` string, nullable, required
      - `image` string, nullable, required
      - `allowedGameModeIds` string[], required
    - `modeMapPools` ApiGameModeMapPool[], required
      - `modeId` string, required
      - `mapIds` string[], required
  - `playlists` ApiGamePlaylist[], required
    - `id` string, required
    - `nameKey` string, required
    - `descriptionKey` string, nullable, required
    - `image` string, nullable, required
    - `allowedGameModeIds` string[], required
  - `timestamp` string, required

## Other responses

- `401` — Missing or invalid API key.
- `404` — Resource not found.
- `429` — Rate limited.
- `500` — Internal server error.

---

[API](https://skmtc.net/teambattles/apis/teambattles-api.md) · [All operations](https://skmtc.net/teambattles/apis/teambattles-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/teambattles/teambattles-api/revisions/2ffe8fb53b7d/schema)