Event Recordings

List recordings for an event

Info

Required scope: storage.read

Warning

This method requires authentication

Retrieve a list of recordings for a specific event, categorized by type: primary videos, secondary videos, and audio files.

  • primaryVideos — the main recording. This is typically a landscape video, but if the stream was portrait-only, the primary video will be portrait.
  • secondaryVideos — a portrait recording, only present when streaming in both landscape and portrait simultaneously.
  • audio — the audio track of the recording.
curl -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/events/{eventId}/recordings

Path Parameters:

ParameterTypeDescription
eventIdstring (UUID)The UUID of the event (required)

Response

Success
Error
{
  "primaryVideos": [
    {
      "fileName": "video-2026-02-26-22-01-19.mp4",
      "expiresAt": "2026-03-08T22:01:19.000Z"
    }
  ],
  "secondaryVideos": [
    {
      "fileName": "video-1772143281190-2026-02-26-22-01-22.mp4",
      "expiresAt": "2026-03-08T22:01:19.000Z"
    }
  ],
  "audio": [
    {
      "fileName": "audio-2026-02-26-22-01-19.m4a",
      "expiresAt": "2026-03-08T22:01:19.000Z"
    }
  ]
}