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

# Get sessions



## OpenAPI

````yaml /openapi.json get /sessions/{session_id}
openapi: 3.0.0
info:
  title: Kair Voice
  version: '1.0'
servers:
  - url: http://0.0.0.0:8000/api
security: []
tags:
  - name: Admin
  - name: ApiKey
  - name: Auth
  - name: Concerns
  - name: Device
  - name: Graph
  - name: Health
  - name: Job
  - name: Session
  - name: Workshop
  - name: Workspace
paths:
  /sessions/{session_id}:
    get:
      tags:
        - Session
      operationId: get-sessions-session-id
      parameters:
        - name: session_id
          schema:
            type: string
            format: uuid
          in: path
          required: true
          deprecated: false
          explode: true
      responses:
        '200':
          description: ''
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/SessionDetailResponse'
        '404':
          description: ''
components:
  schemas:
    SessionDetailResponse:
      type: object
      title: SessionDetailResponse
      required:
        - session
        - audios
        - transcriptions
        - summaries
        - hirag_job_queued
      properties:
        session:
          $ref: '#/components/schemas/SessionResponse'
        audios:
          type: array
          items:
            $ref: '#/components/schemas/AudioResponse'
        transcriptions:
          type: array
          items:
            $ref: '#/components/schemas/TranscriptionResponse'
        summaries:
          type: array
          items:
            $ref: '#/components/schemas/SummaryResponse'
        hirag_job_queued:
          type: boolean
    SessionResponse:
      type: object
      title: SessionResponse
      required:
        - id
        - title
        - metadata
        - created_at
        - updated_at
        - workspace_id
        - session_type
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        metadata: {}
        created_at:
          type: string
        updated_at:
          type: string
        workspace_id:
          type: string
          format: uuid
        workspace_name:
          type: string
        workspace_type:
          type: string
        target_language:
          type: string
        session_type:
          type: string
        ingest_method:
          type: string
        source_file_name:
          type: string
    AudioResponse:
      type: object
      title: AudioResponse
      required:
        - id
        - workspace_id
        - filename
        - uploaded_at
      properties:
        id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        session_id:
          type: string
          format: uuid
          description: >-
            NULL when the audio lives at workspace scope (Content Library
            upload);

            populated when recorded/uploaded within a session.
        filename:
          type: string
        duration_seconds:
          type: number
          format: float
        uploaded_at:
          type: string
    TranscriptionResponse:
      type: object
      title: TranscriptionResponse
      required:
        - id
        - workspace_id
        - created_at
      properties:
        id:
          type: string
          format: uuid
        audio_id:
          type: string
          format: uuid
        audio_chunk_id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        session_id:
          type: string
          format: uuid
          description: NULL when the transcription's audio lives at workspace scope.
        job_id:
          type: string
          format: uuid
        transcription_text:
          type: string
        detected_language:
          type: string
        job_status:
          type: string
        progress_percentage:
          type: integer
          format: int32
        error_message:
          type: string
        wall_clock_secs:
          type: number
          format: double
        created_at:
          type: string
        completed_at:
          type: string
        diarisation_model_version:
          type: string
          description: >-
            Identifier of the diariser used (e.g.
            `pyannote/speaker-diarization-3.1`).

            `None` means diarisation hasn't run for this transcription.
    SummaryResponse:
      type: object
      title: SummaryResponse
      required:
        - id
        - workspace_id
        - summary_text
        - summary_type
        - job_status
        - progress_percentage
        - created_at
      properties:
        id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        session_id:
          type: string
          format: uuid
          description: |-
            NULL for workspace-scope summaries (document/transcript summaries of
            Content Library content).
        source_id:
          type: string
          format: uuid
        summary_text:
          type: string
        summary_type:
          type: string
        inference_backend:
          type: string
        job_status:
          type: string
        progress_percentage:
          type: integer
          format: int32
        error_message:
          type: string
        created_at:
          type: string
        completed_at:
          type: string

````