---
title: "Streams"
method: GET
path: "/clubs/{club_id}/streams"
tags: ["Stream"]
---

# Streams

`GET /clubs/{club_id}/streams`

## Request

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

Returns a list of streams.

## Path parameters

- `club_id` integer, required

## Query parameters

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

## Headers

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

## Response `200`

OK

- object
  - `data` object[]: List of streams.
    - `id` integer: ID of the stream.
    - `club_id` integer: ID of the associated club.
    - `handle` string: Handle of the stream.
    - `title` string: Title of the stream.
    - `link` string: API URL to the stream.
    - `last_posted_at` string, date-time: The datetime of the stream's most recent post.
    - `cover` object
      - `file` object: The streams's cover image, in different sizes.
        - `small` string: URL to the small sized image.
        - `medium` string: URL to the medium sized image.
        - `large` string: URL to the large sized image.
    - `locale` string: Locale of the object. 'de-DE', 'en-GB' or 'nl-NL'. This locale must be whitelisted for your club!
    - `accounts` object[]: List of accounts.
      - `id` integer: ID of the account.
      - `name` string: Name of the account.
      - `group_id` integer: ID of the group which is associated to this account.
      - `type` 'facebook' | 'twitter' | 'youtube' | 'graph_instagram': Type of account.

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