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

# Stream

`GET /clubs/{club_id}/streams/{handle}`

## Request

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

Returns posts of a stream.

## Path parameters

- `club_id` integer, required
- `handle` string, required

## Query parameters

- `limit` integer
- `page` integer
- `since` string, date-time
- `until` string, date-time
- `networks[]` string[]

## Headers

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

## Response `200`

OK

- object
  - `data` object[]: List of posts.
    - `id` integer: ID of the post.
    - `external_id` integer: ID of the external post.
    - `external_url` string: URL to the external resource.
    - `published_at` string, date-time: Date and time when the post was published.
    - `profile_image_url` string: URL to the profile image.
    - `image` object: Object containing the optimized image URLs. Use this to achieve the best performance.
      - `medium` object: Image with max size of 640 x 640 pixels.
        - `url` string: URL to a video if the activity source contains one.
    - `image_url` string: URL to the image which is associated with the post.
    - `image_width` integer: Width in pixels of the image.
    - `image_height` integer: Height in pixels of the image.
    - `video_url` string: URL to the video which is associated with the post.
    - `account` object
      - `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.
      - `username` string: Username of the account.
      - `full_name` string: Full name of the account.
      - `display_name` string: Display name of the account.
      - `handle` string: Handle
    - `type` string

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