# List stream recordings by stream
`GET https://octopus.livepush.io/streams/{stream_id}/recordings`
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.
- **Tag:** Stream Recordings
- **Operation ID:** `getStreamsStreamIdRecordings`
- **Authentication:** Bearer token required
- **Docs:** https://developers.livepush.io/stream-recordings/list-stream-recordings-by-stream/

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `stream_id` | string | yes | Unique identifier of the live stream |


### Example request

```bash
curl -X GET 'https://octopus.livepush.io/streams/<stream_id>/recordings' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
```


### Responses


#### 200 — List of stream recordings

- _array of Recording_
- `id` (string) — Public identifier of the recording
- `_id` (string) — Internal database identifier
- `user` (string) — User identifier who owns the recording
- `stream` (string) — Live stream identifier associated with the recording
- `streamKey` (string) — RTMP stream key used during the recording session
- `time` (string<date-time>) — Time when the recording session started
- `updatedAt` (string<date-time>) — Last update timestamp of the recording
- `sourceReadyAt` (string<date-time>) — Time when the recording source became available
- `duration` (number<float>) — Duration of the recording in seconds
- `size` (number) — 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
- `vendor` (string) — Backend vendor handling the recording
- `sourceHost` (string) — Internal source host handling the recording
- `ns` (string) — Namespace identifier
- `preKey` (string) — Internal object storage key for the recording file
- `screenshot` (string) — Screenshot URL or identifier for the recording
- `error` (string) — Error message if recording processing failed
- `isRecordingDisabled` (boolean) — Indicates whether recording was disabled for the stream
- `mediaInfo` (object) — Technical media metadata of the recording
  - `codec` (string)
  - `profile` (string)
  - `fps` (number)
  - `width` (integer)
  - `height` (integer)
  - `pix_fmt` (string)


```json
[
  {
    "id": "recLuF0EKePs",
    "_id": "6956c9137a06c9debc18863e",
    "user": "0PoArI-B3",
    "stream": "stZ-mQc33cFxfeRH",
    "streamKey": "string",
    "time": "2026-01-31T09:00:00.000Z",
    "updatedAt": "2026-01-31T09:00:00.000Z",
    "sourceReadyAt": "2026-01-31T09:00:00.000Z",
    "duration": 390.465,
    "size": 0,
    "queued": false,
    "unlocked": false,
    "watchable": false,
    "exportable": false,
    "cleanable": false,
    "cleaned": false,
    "recordingTier": "c_startup",
    "vendor": "flu",
    "sourceHost": "string",
    "ns": "string",
    "preKey": "string",
    "screenshot": "string",
    "error": "string",
    "isRecordingDisabled": false,
    "mediaInfo": {
      "codec": "h264",
      "profile": "Main",
      "fps": 30,
      "width": 1920,
      "height": 1080,
      "pix_fmt": "yuv420p"
    }
  }
]
```


#### 401 — Unauthorized


#### 404 — Stream not found