---
title: "Calendar"
method: GET
path: "/clubs/{club_id}/calendars/{id}"
tags: ["Calendar"]
---

# Calendar

`GET /clubs/{club_id}/calendars/{id}`

## Request

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

Returns a calendar by ID.

You could also fetch the calendar in iCalendar format if you set `Accept: text/calendar` or use the `.ics` extension.

## Path parameters

- `club_id` integer, required
- `id` integer, required

## Query parameters

- `categories[]` string[]
- `locale` 'de-DE' | 'en-GB' | 'nl-NL'

## Headers

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

## Response `200`

OK

- object
  - `data` object
    - `id` string: ID of the calendar.
    - `title` string: Display title of the calendar.
    - `timezone` string: Timezone of the calendar.
    - `locale` string: Locale of the object. 'de-DE', 'en-GB' or 'nl-NL'. This locale must be whitelisted for your club!
    - `events` object[]: Events in the calendar.
      - `title` string: Title of the event.
      - `uid` string: iCalendar conform UID.
      - `starts_at` string, date-time: Time which the event starts.
      - `ends_at` string, date-time: Time which the event ends.
      - `description` string: Description of the event. **NOTE**: the info will always be in the locale which is provide
      - `location` string: Location of the event.
      - `geo` string: Comma separated coordinates of the event location.
      - `categories` string[]: Categories of the event.
      - `day_long` boolean: True if the event is day long.

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