Livepush Developers

Stream Recordings

List user stream recordings

GET https://octopus.livepush.io/streams/me/recordings

Base URL https://octopus.livepush.io — Core Streams & Media APIs

Returns the list of stream recordings owned by the authenticated user.

These recordings are generated from live streams and may include completed, queued, or errored recording entries.

Authorization

Send a valid access token in the Authorization header.

  • bearerAuth — Bearer token (JWT)
headers.txt 
Authorization: Bearer YOUR_API_TOKEN

Try it

GET https://octopus.livepush.io/streams/me/recordings — This call only reads data.

Code samples

request.sh 
curl -X GET 'https://octopus.livepush.io/streams/me/recordings' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://octopus.livepush.io/streams/me/recordings', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN',
  },
});

if (!response.ok) {
  throw new Error(`Livepush API error ${response.status}`);
}

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer YOUR_API_TOKEN',
}

response = requests.get('https://octopus.livepush.io/streams/me/recordings', headers=headers, timeout=30)
response.raise_for_status()
data = response.json()

Responses

List of user stream recordings

application/json

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
    nullable
  • 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
    nullable
  • error string
    Error message if recording processing failed
    nullable
  • 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
Example 200 response response.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"
    }
  }
]

Unauthorized