Event Recording Transcriptions

List transcriptions for an event's recordings

Info

Required scope: storage.read

Warning

This method requires authentication

Retrieve a list of transcriptions generated for the recordings of a specific event.

Each transcription has a status describing where it is in processing:

  • InProgress — the transcription is queued or currently being generated.
  • Completed — the transcription is ready and downloadUrl points to the transcript file.
  • Failed — the transcription could not be generated, or it has expired and is no longer available.
  • Unknown — the status could not be determined.

downloadUrl is null until the transcription is Completed. Transcriptions are not stored indefinitely — download the file while it is available; an expired transcription is reported as Failed.

curl -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/events/{eventId}/recordings/transcriptions

Path Parameters:

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

Response

Success
Error
{
  "transcriptions": [
    {
      "id": "7f3c9a4e-1b2d-4c5f-8a6b-9d0e1f2a3b4c",
      "fileName": "video-2026-02-26-22-01-19.mp4",
      "status": "Completed",
      "downloadUrl": "https://storage.restream.io/transcriptions/7f3c9a4e-1b2d-4c5f-8a6b-9d0e1f2a3b4c.txt?token=..."
    },
    {
      "id": "2a1b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "fileName": "video-1772143281190-2026-02-26-22-01-22.mp4",
      "status": "InProgress",
      "downloadUrl": null
    }
  ]
}