---
title: "Get Stream Status"
method: GET
path: "/stream/{stream_id}"
tags: ["Apis", "Streaming"]
---

# Get Stream Status

`GET /stream/{stream_id}`

Retrieve the current status of a stream, including source connection details and the state and URLs of every output.

## Path parameters

- `stream_id` integer, required

## Response `200`

Current state of the stream.

- StreamView — Current state of a stream. The shape is identical whether the stream is scheduled, live, or finished.
  - `stream_id` integer
  - `status` 1 | 2 | 3 | 4 | 5 | 6 — Lifecycle status of a stream. | Value | Status | Description | |---|---|---| | `1` | Scheduled | Created and waiting for its start time. | | `2` | Setting up | Resources are being provisioned. | | `3` | Started | Live and processing. | | `4` | Ended | Completed normally. | | `5` | Interrupted | Stopped before its scheduled end. | | `6` | Error | Failed; see the `error` field. |
  - `source` SourceView
    - `type` 1 | 2 | 3 | 4 | 5 | 6 — Protocol/type of a target stream. | Value | Type | Description | |---|---|---| | `1` | SRT caller | Push output to your SRT endpoint (Camb.ai connects out to `url`). | | `2` | RTMP | Push output to an RTMP ingest `url`. | | `3` | HLS recording | Camb.ai-hosted HLS output; `url` and `inputs` are auto-assigned, and the playback URL is returned. | | `4` | YouTube RTMP | Push directly to a YouTube RTMP ingest URL. | | `5` | YouTube HLS | Push directly to a YouTube HLS ingest URL. | | `6` | SRT listener | Camb.ai hosts an SRT endpoint that you (or your player) pull from; `url` is auto-assigned and returned. |
    - `playback_url` string, nullable — URL where the source can be played back, when available.
  - `targets` TargetView[] — State and URLs of each output.
    - `id` string — Target identifier from the create payload.
    - `type` 1 | 2 | 3 | 4 | 5 | 6 — Protocol/type of a target stream. | Value | Type | Description | |---|---|---| | `1` | SRT caller | Push output to your SRT endpoint (Camb.ai connects out to `url`). | | `2` | RTMP | Push output to an RTMP ingest `url`. | | `3` | HLS recording | Camb.ai-hosted HLS output; `url` and `inputs` are auto-assigned, and the playback URL is returned. | | `4` | YouTube RTMP | Push directly to a YouTube RTMP ingest URL. | | `5` | YouTube HLS | Push directly to a YouTube HLS ingest URL. | | `6` | SRT listener | Camb.ai hosts an SRT endpoint that you (or your player) pull from; `url` is auto-assigned and returned. |
    - `state` 'scheduled' | 'deferred' | 'active' | 'completed' | 'failed' — Lifecycle state of this target output.
    - `playback_url` string, nullable — URL to play this output, for Camb.ai-hosted outputs.
    - `destination_url` string, nullable — URL this output is being pushed to, for push-type targets.
  - `scheduled_at` string, date-time, nullable
  - `started_at` string, date-time, nullable
  - `stopped_at` string, date-time, nullable
  - `task_id` string, nullable — Setup task identifier.
  - `error` string, nullable — Failure description when `status` is `6` (error).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/camb/apis/fastapi.md) · [All operations](https://skmtc.net/camb/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/camb/fastapi/revisions/40ebeee64850/schema)