> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daydream.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Stream Status

> Check the status of your stream

The stream status uses the following url, make sure to include your stream Id.


## OpenAPI

````yaml GET /v1/streams/{id}/status
openapi: 3.1.0
info:
  title: Daydream API Documentation
  description: API documentation for Daydream API
  version: 1.0.0
servers:
  - url: https://api.daydream.live
    description: Production server
security: []
paths:
  /v1/streams/{id}/status:
    get:
      tags:
        - Streams
      summary: Get stream status
      description: Gets the status of a specific stream
      operationId: getStreamStatus
      parameters:
        - schema:
            type: string
            minLength: 1
          in: path
          name: id
          required: true
          description: ID of the stream to get status for
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    nullable: true
                  data:
                    anyOf:
                      - type: object
                        properties:
                          stream_id:
                            description: Stream identifier
                            type: string
                          request_id:
                            description: Gateway request identifier
                            type: string
                          pipeline_id:
                            description: Pipeline identifier
                            type: string
                          type:
                            description: Event type (e.g. 'status')
                            type: string
                          orchestrator_info:
                            type: object
                            properties:
                              address:
                                type: string
                              url:
                                type: string
                                format: uri
                            additionalProperties: {}
                          inference_status:
                            type: object
                            properties:
                              pipeline:
                                type: string
                              start_time:
                                description: Unix seconds
                                type: number
                              last_params_update_time:
                                description: Unix seconds
                                type: number
                              last_params:
                                description: Model/pipeline parameters
                              last_params_hash:
                                type: string
                              input_fps:
                                type: number
                              output_fps:
                                type: number
                              last_input_time:
                                description: Unix seconds
                                type: number
                              last_output_time:
                                description: Unix seconds
                                type: number
                              restart_count:
                                type: integer
                                minimum: -9007199254740991
                                maximum: 9007199254740991
                              last_restart_time:
                                description: Unix seconds
                                type: number
                              last_restart_logs:
                                type: array
                                items:
                                  type: string
                              last_error:
                                type: string
                                nullable: true
                              stream_id:
                                type: string
                            additionalProperties: {}
                          gateway_status:
                            type: object
                            properties:
                              whep_url:
                                type: string
                                format: uri
                              error:
                                type: object
                                properties:
                                  error_message:
                                    type: string
                                  error_time:
                                    description: Unix time in milliseconds
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                required:
                                  - error_message
                                  - error_time
                                additionalProperties: false
                              ingest_metrics:
                                type: object
                                properties:
                                  stats:
                                    type: object
                                    properties:
                                      peer_conn_stats:
                                        type: object
                                        properties:
                                          ID:
                                            description: Peer connection ID
                                            type: string
                                          BytesReceived:
                                            description: Total bytes received
                                            type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                          BytesSent:
                                            description: Total bytes sent
                                            type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                        required:
                                          - ID
                                          - BytesReceived
                                          - BytesSent
                                        additionalProperties: {}
                                      track_stats:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            type:
                                              description: RTP codec type, e.g. 'audio' or 'video'
                                              type: string
                                            jitter:
                                              type: number
                                            packets_lost:
                                              type: integer
                                              minimum: -9007199254740991
                                              maximum: 9007199254740991
                                            packets_received:
                                              type: integer
                                              minimum: -9007199254740991
                                              maximum: 9007199254740991
                                            packet_loss_pct:
                                              type: number
                                            rtt:
                                              description: Round trip time in nanoseconds
                                              type: number
                                            warnings:
                                              type: array
                                              items:
                                                type: string
                                          required:
                                            - type
                                            - jitter
                                            - packets_lost
                                            - packets_received
                                            - packet_loss_pct
                                            - rtt
                                          additionalProperties: {}
                                      conn_quality:
                                        description: Connection quality assessment
                                        type: string
                                        enum:
                                          - good
                                          - bad
                                          - unknown
                                    required:
                                      - peer_conn_stats
                                      - conn_quality
                                    additionalProperties: {}
                                required:
                                  - stats
                                additionalProperties: {}
                            additionalProperties: {}
                          pipeline:
                            description: Model/pipeline name (if present)
                            type: string
                        required:
                          - stream_id
                          - request_id
                          - pipeline_id
                        additionalProperties: {}
                      - type: object
                        properties:
                          state:
                            type: string
                            enum:
                              - OFFLINE
                          info:
                            type: string
                        required:
                          - state
                        additionalProperties: false
                      - type: object
                        properties:
                          gateway_status:
                            type: object
                            properties:
                              whep_url:
                                type: string
                                format: uri
                              error:
                                type: object
                                properties:
                                  error_message:
                                    type: string
                                  error_time:
                                    description: Unix time in milliseconds
                                    type: integer
                                    minimum: -9007199254740991
                                    maximum: 9007199254740991
                                required:
                                  - error_message
                                  - error_time
                                additionalProperties: false
                              ingest_metrics:
                                type: object
                                properties:
                                  stats:
                                    type: object
                                    properties:
                                      peer_conn_stats:
                                        type: object
                                        properties:
                                          ID:
                                            description: Peer connection ID
                                            type: string
                                          BytesReceived:
                                            description: Total bytes received
                                            type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                          BytesSent:
                                            description: Total bytes sent
                                            type: integer
                                            minimum: -9007199254740991
                                            maximum: 9007199254740991
                                        required:
                                          - ID
                                          - BytesReceived
                                          - BytesSent
                                        additionalProperties: {}
                                      track_stats:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            type:
                                              description: RTP codec type, e.g. 'audio' or 'video'
                                              type: string
                                            jitter:
                                              type: number
                                            packets_lost:
                                              type: integer
                                              minimum: -9007199254740991
                                              maximum: 9007199254740991
                                            packets_received:
                                              type: integer
                                              minimum: -9007199254740991
                                              maximum: 9007199254740991
                                            packet_loss_pct:
                                              type: number
                                            rtt:
                                              description: Round trip time in nanoseconds
                                              type: number
                                            warnings:
                                              type: array
                                              items:
                                                type: string
                                          required:
                                            - type
                                            - jitter
                                            - packets_lost
                                            - packets_received
                                            - packet_loss_pct
                                            - rtt
                                          additionalProperties: {}
                                      conn_quality:
                                        description: Connection quality assessment
                                        type: string
                                        enum:
                                          - good
                                          - bad
                                          - unknown
                                    required:
                                      - peer_conn_stats
                                      - conn_quality
                                    additionalProperties: {}
                                required:
                                  - stats
                                additionalProperties: {}
                            additionalProperties: {}
                        required:
                          - gateway_status
                        additionalProperties: {}
                required:
                  - success
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
        '429':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    description: Always false for error responses
                    default: false
                    type: boolean
                  error:
                    description: User-facing error message
                    type: string
                  code:
                    description: >-
                      Stable machine-readable error code, e.g.,
                      STREAMS/NOT_FOUND
                    type: string
                  status:
                    description: HTTP status code
                    type: number
                  details:
                    description: Optional structured details about the error
                  requestId:
                    description: Request identifier for correlation
                    type: string
                  traceId:
                    description: OpenTelemetry trace id for correlation
                    type: string
                required:
                  - success
                  - error
                  - code
                  - status
                additionalProperties: false
      security:
        - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````