> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lyzr.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Stream Transcript Audio

> Stream the raw audio recording (.ogg) of a specific LiveKit session.

Retrieve the actual voice recording of a completed session as an `.ogg` audio file.

While the standard transcript endpoints provide the text version of a conversation, this endpoint allows you to play back the actual human and agent voices. This is incredibly valuable for QA, sentiment analysis, or embedding a playback widget directly into your own application's dashboard.

<Info>
  **Authentication Required:** You must include your API key in the `x-api-key` header to authenticate this request.
</Info>

<Warning>
  **Prerequisites for Audio Playback:** Audio will only be available if `audio_recording_enabled: true` was set in your Agent's configuration when the session took place. Furthermore, your organization must have storage configured to retain these files.
</Warning>

### Required Parameters

* **`sessionId` (Path Parameter):** The unique UUID of the completed LiveKit session.

### Handling the Response

Unlike most of our API endpoints which return JSON, a successful `200 OK` response from this endpoint returns a **binary byte stream** with a `Content-Type` of `audio/ogg`.

**Example usage in a web application:**
Because it returns raw audio, you can often plug this endpoint directly into an HTML `<audio>` tag within your authenticated frontend, or fetch it via a standard GET request and convert it into a Blob for playback.


## OpenAPI

````yaml get /transcripts/{sessionId}/audio
openapi: 3.0.3
info:
  title: Lyzr Voice LiveKit API
  version: 1.0.0
servers:
  - url: https://voice-livekit.studio.lyzr.ai/v1
security: []
paths:
  /transcripts/{sessionId}/audio:
    get:
      summary: Stream Transcript Audio
      description: Stream the raw audio recording (.ogg) of a specific LiveKit session.
      parameters:
        - name: sessionId
          in: path
          required: true
          description: The unique UUID of the LiveKit session.
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      responses:
        '200':
          description: Audio recording retrieved successfully.
          content:
            audio/ogg:
              schema:
                type: string
                format: binary
                description: The binary byte stream of the audio recording.
        '404':
          description: >-
            Transcript/audio not found for the caller scope, or storage is not
            configured.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Audio recording not found.
                  details:
                    type: string
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````