---
title: "Matchday"
method: GET
path: "/clubs/{club_id}/matches/{match_id}/matchday"
tags: ["Matchday"]
---

# Matchday

`GET /clubs/{club_id}/matches/{match_id}/matchday`

## Request

- Base URL: `https://api.clubplatform.de/api`
- URL: `https://api.clubplatform.de/api/clubs/{club_id}/matches/{match_id}/matchday`
- Auth: API key in query parameter `auth_token`

Returns matchday informations for the match.

## Path parameters

- `club_id` integer, required
- `match_id` integer, required

## Query parameters

- `locale` 'de-DE' | 'en-GB' | 'nl-NL'

## Headers

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

## Response `200`

OK

- object
  - `live` boolean: True when the matchay is currently active.
  - `activities_link` string: API URL to the activities endpoint of this matchday.
  - `galleries_link` string: API URL to the galleries endpoint of this matchday.
  - `matchday_widget_link` string: URL to the matchday widget of this matchday.
  - `starts_at` string, date-time: Time to begin the matchday.
  - `ends_at` string, date-time: Time to finish the matchday.

## Other responses

- `304`: Not Modified
- `401`: Unauthorized
- `403`: Forbidden
- `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)