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

# Fetch all livestreams

`GET /livestreams`

## Request

- Base URL: `https://api.dyte.io/v2`
- URL: `https://api.dyte.io/v2/livestreams`
- Auth: HTTP basic

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

## Changes

- **2025-04-04** (v2) `cb67ff854c71`: 1 breaking, 1 info
  - the `data/status` response's property type changed from no type to `string` for status `200`
  - the endpoint scheme security `Authorization` was added to the API
- **2025-04-03** (v2) `68b9e665bfcc`: 1 breaking, 1 info
  - the `data/status` response's property type changed from `string` to no type for status `200`
  - the endpoint scheme security `Authorization` was removed from the API
- **2024-11-20** (v2) `d8c5d90e84ac`: 1 breaking, 1 info
  - the `data/status` response's property type changed from no type to `string` for status `200`
  - the endpoint scheme security `Authorization` was added to the API
- **2023-07-18** (v2) `1d0c9cf27eb0`: 1 warning, 1 info
  - deleted the `query` request parameter `excludeMeetings`
  - added the new optional `query` request parameter `exclude_meetings`
- **2023-07-18** (v2) `709c46a28a8b`: 9 warning, 17 info
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `data/current_page` from the response with the `200` status
  - removed the optional property `data/limit` from the response with the `200` status
  - …22 more

[Operation history](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/changes/livestreams/get.md)

---

[API](https://skmtc.dev/dyte-io/apis/dyte-rest-apis.md) - [All operations](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/revisions/f62d3edd92ae?raw)