---
title: "Schedule of current season for tournament"
method: GET
path: "/tournaments/{tournament_id}/seasons/current_season/schedule"
tags: ["Schedule"]
---

# Schedule of current season for tournament

`GET /tournaments/{tournament_id}/seasons/current_season/schedule`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/tournaments/{tournament_id}/seasons/current_season/schedule`
- Auth: API key in query parameter `auth_token`

Returns list of scheduled matches of the given season and tournament.

## Path parameters

- `tournament_id` integer, required

## Query parameters

- `club_id` integer
- `group_id` integer
- `round` string
- `previous` integer
- `next` integer
- `locale` 'de-DE' | 'en-GB' | 'nl-NL'

## Headers

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

## Response `200`

OK

- object
  - `data` object
    - `season_id` integer: The id of the season.
    - `season_name` string: The name of the season.
    - `tournament_id` integer: The id of the tournament.
    - `tournament_name` string: The name of the tournament. **NOTE**: the info will always be in the locale which is provide
    - `tournament_handle` string: The handle of the tournament.
    - `number_of_rounds` integer: Number of rounds in this season.
    - `divisions` object[]: An array containing the division hashes for this season. Examples for a division are a the group stage of the Euro- or Championsleague, the first or second half of a league or a knockout stage matchday in a Cup
      - `id` integer: The id of the division
      - `name` string: Name of the division **NOTE**: the info will always be in the locale which is provide
      - `rounds` object[]: Rounds in this division.
        - `id` integer: ID of round.
        - `name` string: Name of round.
        - `matches` object[]: Matches in this round.
          - `id` integer: ID of the match.
          - `live` boolean: True when the match is currently running.
          - `in_break` boolean: True when the match is currently in halftime break.
          - `has_overtime` boolean: True when the match had a or is currently in first 15 minutes of overtime.
          - `has_overtime_2` boolean: True when the match had a or is currently in second 15 minutes of overtime.
          - `has_penalty_shootout` boolean: True when match had a or is currently in penalty shootout.
          - `start_date_time` string, date-time: Date and time when the game starts.
          - `start_date_time_quality` 'assumed' | 'definite': | value | description | |:-----------|:--------------------------------------------------| | `assumed` | `start_date_time` is planed but are not definite. | | `definite` | `start_date_time` is definite. |
          - `start_weekday` string: Day of week in which the match starts.
          - `event_status` 'pre-event' | 'post-event' | 'mid-event' | 'halted' | 'canceled' | 'forfeited' | 'postponed' | 'rescheduled' | 'delayed': State of the match. | value | description | |:--------------|:--------------------------------| | `pre-event` | upcoming match | | `post-event` | past match | | `mid-event` | running match | | `halted` | match aborted | | `canceled` | match was canceled | | `forfeited` | match was decided off the field | | `postponed` | match was postponed | | `rescheduled` | match was given a new date | | `delayed` | match started later |
          - `group` object: Group the match is placed in.
            - `id` integer: ID of group.
            - `name` string: Name of group.
          - `site` object: Location where the match will happen.
            - `id` integer: ID of location.
            - `name` string: Name of the location.
            - `built` integer: Year when the venue was built.
            - `roof` boolean: True when venue has a roof.
            - `seats` integer: Number of seats/capacity.
            - `surface` 'artificial_turf' | 'turf': Surface of the stadium.
            - `url` string: URL to the website of the venue.
            - `city` string: City of the venue.
            - `postal_code` string: Postal code of the location.
            - `street` string: Street of the location.
            - `lat` number, float: Latitude of the location.
            - `lng` number, float: Longitude of the location.
            - `pitch` object: Size of the pitch.
              - …
          - `teams` object[]: List of teams for this match.
            - `id` integer: ID of the team.
            - `name` string: Name of the team.
            - `nickname` string: Nickname of the team.
            - `handle` string: Handle of the team.
            - `lineup_complete` string: True when lineup is completed.
            - `alignment` 'away' | 'home': Alignment of the team.
            - `score` object: Score of this team in this match.
              - …
            - `club` object
              - …
            - `liveticker` object: Informations about the liveticker.
              - …
            - `matchday` object: Informations about the matchday.
              - …
          - `video_id` integer: This match's associated video ID, if existent.
          - `match_name` string: optional name of the match.

## Other responses

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

---

[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)