> ## 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.

# Get Transcript

> Retrieve the complete, detailed transcript document for a specific session ID within the caller's authorized scope.

Retrieve the full, granular record of a single Voice Agent conversation.

While the [List Transcripts](/api-reference/transcripts/list-transcripts) endpoint is great for dashboards and overviews, this endpoint is used when you need to drill down into the exact turn-by-turn dialogue of a specific user interaction.

<Info>
  **Authentication Required:** You must include your API key in the `x-api-key` header. You can only fetch transcripts that belong to your organization or authorized scope.
</Info>

### Required Parameters

* **`sessionId` (Path Parameter):** The unique UUID of the session you want to retrieve. You typically receive this ID when a session is first initiated, or you can find it by querying the List Transcripts endpoint.

### Understanding the Transcript Document

When a session concludes, our engine compiles all the raw audio events, transcription data, and agent logic into a single JSON document.

A successful `200 OK` response will return a `transcript` object containing:

* **`chatHistory`**: The exact sequence of messages exchanged between the human and the AI. This includes the parsed text of what the user said (via STT) and the text the LLM generated in response.
* **`sessionReport`**: If your agent is configured to extract structured data (like a lead's name, intent, or a summary of the call), that JSON data will appear here.
* **Core Analytics**: Dive into exactly how the call performed using `durationMs` (length of the call), `messageCount` (how back-and-forth it was), and the timestamps (`startedAt`, `endedAt`).
* **`closeReason`**: Understand exactly *why* the call ended. Was it an intentional hang-up, a network timeout, or did the agent gracefully conclude the conversation?


## OpenAPI

````yaml get /transcripts/{sessionId}
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}:
    get:
      summary: Get Transcript
      description: >-
        Retrieve the complete, detailed transcript document for a specific
        session ID within the caller's authorized scope.
      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: Transcript document retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  transcript:
                    type: object
                    properties:
                      id:
                        type: string
                      sessionId:
                        type: string
                        format: uuid
                      roomName:
                        type: string
                      agentId:
                        type: string
                      orgId:
                        type: string
                        format: uuid
                      createdByUserId:
                        type: string
                      sessionReport:
                        type: object
                        additionalProperties: true
                      chatHistory:
                        type: array
                        items:
                          type: object
                          additionalProperties: true
                      closeReason:
                        type: string
                      durationMs:
                        type: integer
                      messageCount:
                        type: integer
                      startedAt:
                        type: string
                        format: date-time
                      endedAt:
                        type: string
                        format: date-time
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
        '404':
          description: Transcript not found for the provided session ID or caller scope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Transcript not found.
                  details:
                    type: string
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````