---
title: "Tournaments"
method: GET
path: "/tournaments"
tags: ["Tournament"]
---

# Tournaments

`GET /tournaments`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/tournaments`
- Auth: API key in query parameter `auth_token`

Returns the list of tournaments.

## Headers

- `If-Modified-Since` string, date-time

## Response `200`

OK

- object
  - `data` object[]: List of tournaments.
    - `id` integer: ID of tournament.
    - `name` string: Name of tournament.
    - `handle` string: Handle of tournament.
    - `number_of_rounds` integer: Number of rounds in this tournament. Is `null` when the tournaments has no rounds.
    - `seasons_link` string: API URL to seasons endpoint of this tournament
    - `logo` object: URL to logo in different resultions.
      - `medium` string: URL to logo in medium resolution (300x300).
      - `mini` string: URL to logo in mini resolution (30x30).
      - `icon_mini` string: URL to logo in icon resolution (24x24).

## Other responses

- `304`: Not Modified
- `401`: Unauthorized

---

[API](https://skmtc.dev/clubplatform/apis/clubplatform-api.md) - [All operations](https://skmtc.dev/clubplatform/apis/clubplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clubplatform/apis/clubplatform-api/revisions/5c107a185e03?raw)