# List stream recordings by stream

Returns the list of recordings generated for a specific live stream.

This endpoint is useful for retrieving all historical recordings
associated with a single stream.

Endpoint: GET /streams/{stream_id}/recordings
Version: 1.0.0
Security: bearerAuth

## Path parameters:

  - `stream_id` (string, required)
    Unique identifier of the live stream

## Response 200 fields (application/json):

  - `id` (string)
    Public identifier of the recording
    Example: "recLuF0EKePs"

  - `_id` (string)
    Internal database identifier
    Example: "6956c9137a06c9debc18863e"

  - `user` (string)
    User identifier who owns the recording
    Example: "0PoArI-B3"

  - `stream` (string)
    Live stream identifier associated with the recording
    Example: "stZ-mQc33cFxfeRH"

  - `streamKey` (string)
    RTMP stream key used during the recording session

  - `time` (string)
    Time when the recording session started

  - `updatedAt` (string)
    Last update timestamp of the recording

  - `sourceReadyAt` (string)
    Time when the recording source became available

  - `duration` (number)
    Duration of the recording in seconds
    Example: 390.465

  - `size` (number,null)
    Size of the recording file in bytes

  - `queued` (boolean)
    Indicates whether the recording is queued for processing

  - `unlocked` (boolean)
    Indicates whether the recording is unlocked for access

  - `watchable` (boolean)
    Indicates whether the recording can be played

  - `exportable` (boolean)
    Indicates whether the recording can be exported

  - `cleanable` (boolean)
    Indicates whether the recording is eligible for cleanup

  - `cleaned` (boolean)
    Indicates whether the recording has been cleaned

  - `recordingTier` (string)
    Recording tier associated with the account
    Example: "c_startup"

  - `vendor` (string)
    Backend vendor handling the recording
    Example: "flu"

  - `sourceHost` (string)
    Internal source host handling the recording

  - `ns` (string)
    Namespace identifier

  - `preKey` (string)
    Internal object storage key for the recording file

  - `screenshot` (string,null)
    Screenshot URL or identifier for the recording

  - `error` (string,null)
    Error message if recording processing failed

  - `isRecordingDisabled` (boolean)
    Indicates whether recording was disabled for the stream

  - `mediaInfo` (object)
    Technical media metadata of the recording

  - `mediaInfo.codec` (string)
    Example: "h264"

  - `mediaInfo.profile` (string)
    Example: "Main"

  - `mediaInfo.fps` (number)
    Example: 30

  - `mediaInfo.width` (integer)
    Example: 1920

  - `mediaInfo.height` (integer)
    Example: 1080

  - `mediaInfo.pix_fmt` (string)
    Example: "yuv420p"


## Response 401 fields

## Response 404 fields