---
title: "Events"
method: GET
path: "/clubs/{club_id}/events"
tags: ["EventMode"]
---

# Events

`GET /clubs/{club_id}/events`

## Request

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

Returns a list of event_mode events for the club.

## Path parameters

- `club_id` integer, required

## Query parameters

- `limit` integer
- `page` integer
- `since` string, date-time
- `until` string, date-time

## Headers

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

## Response `200`

OK

- object
  - `data` object[]: Array of events.
    - `id` integer: ID of the events.
    - `name` string, required: Name of the events.
    - `live` boolean: Live status of the event.
    - `images` object[]: List of images.
      - `url` string, required: URL of the image.
      - `width` integer: Width of the image.
      - `height` integer: Height of the image.
      - `orientation` string: Orientation of the image. "landscape", "square" or "portrait"
      - `size` object: Different sizes of the teaser image.
        - `small` string: URL to the small sized image.
        - `medium` string: URL to the medium sized image.
        - `large` string: URL to the large sized image.
    - `sponsor` object
      - `name` string: Name of the sponsor.
      - `logo` object: Logo of the sponsor.
        - `url` string, required: URL of the image.
        - `width` integer: Width of the image.
        - `height` integer: Height of the image.
        - `orientation` string: Orientation of the image. "landscape", "square" or "portrait"
        - `size` object: Different sizes of the teaser image.
          - `small` string: URL to the small sized image.
          - `medium` string: URL to the medium sized image.
          - `large` string: URL to the large sized image.
    - `start_weekday` string: Day of week in which the match starts.
    - `start_date_time` string, date-time, required: Date and time when the game starts.
    - `club` object: Club to which the event belongs.
    - `stream` object, required: Stream for the event.
      - `available` boolean: Stream available for this event or not.
      - `live` boolean: If the stream has started (based on start date/time for the stream)
      - `link` string: Api link to the stream
    - `site` object, required: Location where the match will happen.
      - `name` string: Name of the location.
      - `city` string: City of the venue.
      - `postal_code` string: Postal code of the location.
      - `street` string: Street of the location.

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