---
title: "Fetch all livestreams"
method: GET
path: "/livestreams"
tags: ["Live streams"]
---

# Fetch all livestreams

`GET /livestreams`

Returns details of livestreams associated with the given organization ID. It includes livestreams created by your organization and Dyte meetings that are livestreamed by your organization. If you only want details of livestreams created by your organization and not Dyte meetings, you can use the `exclude_meetings` query parameter.

## Query parameters

- `exclude_meetings` boolean
- `per_page` integer
- `page_no` integer
- `status` 'LIVE' | 'IDLE' | 'ERRORED' | 'INVOKED'
- `start_time` string, date-time
- `end_time` string, date-time
- `sort_order` 'ASC' | 'DSC'

## Response `200`

OK

- object
  - `success` boolean
  - `data` object
    - `status` 'LIVE' | 'IDLE' | 'ERRORED' | 'INVOKED'
    - `id` string, uuid — The ID of the livestream.
    - `name` string — Name of the livestream.
    - `ingest_server` string — The server URL to which the RTMP encoder sends the video and audio data.
    - `stream_key` string — Unique key for accessing each livestream.
    - `playback_url` string — The web address that viewers can use to watch the livestream.
    - `meeting_id` string — ID of the meeting.
    - `created_at` string, date-time — Timestamp the object was created at. The time is returned in ISO format.
    - `updated_at` string, date-time — Timestamp the object was updated at. The time is returned in ISO format.
    - `disabled` string — Specifies if the livestream was disabled.
    - `paging` object
      - `total_count` integer
      - `start_offset` integer
      - `end_offset` integer

---

[API](https://skmtc.net/dyte-io/apis/dyte-rest-apis.md) · [All operations](https://skmtc.net/dyte-io/apis/dyte-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dyte-io/dyte-rest-apis/versions/f62d3edd92ae/schema)
