Skip to main content
GET
/
games
/
{id}
/
playlists
List playlists for a game
curl --request GET \
  --url https://teambattles.gg/api/v1/games/{id}/playlists \
  --header 'Authorization: Bearer <token>'
{
  "game": {
    "id": "<string>",
    "convexId": "<string>",
    "nameKey": "<string>",
    "shortNameKey": "<string>",
    "descriptionKey": "<string>",
    "category": "<string>",
    "rulesLink": "<string>",
    "coverImage": "<string>",
    "bannerImage": "<string>",
    "defaultTeamSize": 123,
    "hasCompetitiveMode": true,
    "isComingSoon": true,
    "isAvailableForMatchApi": true,
    "modes": [
      {
        "id": "<string>",
        "nameKey": "<string>",
        "descriptionKey": "<string>",
        "image": "<string>",
        "shortName": "<string>",
        "rewardBonus": 123,
        "supportsDraftToggle": true,
        "mapIds": [
          "<string>"
        ]
      }
    ],
    "maps": [
      {
        "id": "<string>",
        "nameKey": "<string>",
        "coverImage": "<string>",
        "minimapImage": "<string>",
        "isReleased": true
      }
    ],
    "playlists": [
      {
        "id": "<string>",
        "nameKey": "<string>",
        "descriptionKey": "<string>",
        "image": "<string>",
        "allowedGameModeIds": [
          "<string>"
        ]
      }
    ],
    "modeMapPools": [
      {
        "modeId": "<string>",
        "mapIds": [
          "<string>"
        ]
      }
    ]
  },
  "playlists": [
    {
      "id": "<string>",
      "nameKey": "<string>",
      "descriptionKey": "<string>",
      "image": "<string>",
      "allowedGameModeIds": [
        "<string>"
      ]
    }
  ],
  "timestamp": "<string>"
}

Permission Required

This endpoint requires a valid API key, but no additional permission scope.

Game Identifier

The {id} path parameter is the public static game ID or slug from GET /games, not a Convex document ID.

Authorizations

Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

id
string
required

Static public game ID/slug.

Response

Public game playlist list.

Game-scoped playlist response.

game
object
required

Static public game catalog entry.

playlists
object[]
required
timestamp
string
required