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

# Get Conversation Detail

> Fetch conversation metadata, recording status, avatar info, and transcript rows for a conversation session.

Use this endpoint to retrieve conversation metadata, recording status, avatar info, and transcript rows for a specific conversation session.

This is useful when you want to:

* show a conversation details view in your app
* inspect transcript rows for a past session
* check whether a recording exists and whether it is ready


## OpenAPI

````yaml openapi/akapulu.json GET /conversations/{conversation_session_id}
openapi: 3.1.0
info:
  title: Akapulu Labs API
  version: 1.0.0
  description: Public Akapulu Labs API reference.
servers:
  - url: https://akapulu.com/api
security:
  - bearerAuth: []
paths:
  /conversations/{conversation_session_id}:
    get:
      summary: Get conversation detail
      description: >-
        Fetch conversation metadata, recording status, avatar info, and
        transcript rows for a conversation session.
      parameters:
        - name: conversation_session_id
          in: path
          required: true
          description: Conversation session ID.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Conversation detail fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationDetailResponse'
              examples:
                success:
                  value:
                    id: 7f1e7f76-b38d-4d03-b8f8-2570ce8d4e6d
                    created_at: '2026-03-10T18:10:02.221Z'
                    created_at_text: Mar 10, 2026 06:10 PM
                    duration_text: 4 minutes
                    avatar:
                      id: 66666666-7777-8888-9999-000000000000
                      href: /catalog/66666666-7777-8888-9999-000000000000/
                      profile_image_url: https://signed-avatar-image-url
                    scenario_id: 11111111-2222-3333-4444-555555555555
                    recording:
                      has_recording: true
                      status_text: Recording ready
                      is_ready: true
                    transcript_rows:
                      - role: user
                        content: Hi, I want to learn more about Akapulu Labs.
                        node_id: Greeting
                      - role: assistant
                        content: Absolutely. What are you hoping to build?
                        node_id: Greeting
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: Conversation session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
              examples:
                missing_session:
                  value:
                    error: ConversationSession not found
components:
  schemas:
    ConversationDetailResponse:
      type: object
      required:
        - id
        - created_at
        - created_at_text
        - duration_text
        - avatar
        - scenario_id
        - recording
        - transcript_rows
      properties:
        id:
          type: string
          format: uuid
        created_at:
          type: string
          description: ISO-8601 creation timestamp.
        created_at_text:
          type: string
          description: Human-readable local creation timestamp.
        duration_text:
          type: string
          description: Human-readable conversation duration.
        avatar:
          $ref: '#/components/schemas/ConversationAvatarSummary'
        scenario_id:
          type: string
          format: uuid
        recording:
          $ref: '#/components/schemas/ConversationRecordingStatus'
        transcript_rows:
          type: array
          items:
            $ref: '#/components/schemas/ConversationTranscriptRow'
    ApiError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message.
    ConversationAvatarSummary:
      type: object
      required:
        - id
        - href
        - profile_image_url
      properties:
        id:
          type: string
          description: Avatar ID as text.
        href:
          type: string
          description: Relative app URL for the avatar or catalog detail page.
        profile_image_url:
          type: string
          description: Signed profile image URL if available, otherwise an empty string.
    ConversationRecordingStatus:
      type: object
      required:
        - has_recording
        - status_text
        - is_ready
      properties:
        has_recording:
          type: boolean
        status_text:
          type: string
        is_ready:
          type: boolean
    ConversationTranscriptRow:
      type: object
      required:
        - role
      properties:
        role:
          type: string
        content:
          type: string
        tool_call_id:
          type: string
        tool_calls:
          type: array
          items:
            type: object
            additionalProperties: true
        node_id:
          type: string
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````