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

# List Session Documents

> Fetch a session's full record — status, patient details, audio quality matrix and, most importantly, the list of **all documents** generated or created on the session (notes, transcripts, custom documents). Set `presigned=true` to include a download URL for each document.


Fetch a session's record with **all its documents** — notes, transcripts, custom docs. Add `?presigned=true` to get a download URL per document.


## OpenAPI

````yaml GET /voice/api/v1/sessions/{session_id}
openapi: 3.0.1
info:
  title: EkaScribe Protocol API (MedScribeAlliance v0.1)
  version: '0.1'
  description: >
    Session-based medical voice capture API implementing the MedScribeAlliance
    Protocol v0.1. Discover service capabilities, create a session, stream audio
    chunks, then end the session to trigger asynchronous transcription and
    structured-template extraction.
servers:
  - url: https://api.eka.care
    description: Production server
  - url: https://api.dev.eka.care
    description: Development server
security: []
paths:
  /voice/api/v1/sessions/{session_id}:
    get:
      tags:
        - documents
      summary: List Session Documents
      description: >
        Fetch a session's full record — status, patient details, audio quality
        matrix and, most importantly, the list of **all documents** generated or
        created on the session (notes, transcripts, custom documents). Set
        `presigned=true` to include a download URL for each document.
      parameters:
        - name: session_id
          in: path
          required: true
          description: Session ID
          schema:
            type: string
            example: ses_abc123def456
        - name: presigned
          in: query
          required: false
          description: Include a presigned download URL per document
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Session details with its documents
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionDetailsResponse'
              example:
                status: success
                data:
                  schema_version: '1.0'
                  session_id: ses_abc123def456
                  status: completed
                  created_at: '2026-06-06T14:21:07Z'
                  patient_details:
                    oid: PAT-12345
                    name: John Doe
                  audio_matrix:
                    quality: 0.92
                  documents:
                    - document_id: doc_9f8e7d6c
                      session_id: ses_abc123def456
                      template_id: clinical_notes_template
                      document_name: Clinical note
                      type: template
                      status: success
                      download_url: https://s3.amazonaws.com/...
                      created_at: '2026-06-06T14:21:30Z'
        '404':
          description: Session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - auth: []
components:
  schemas:
    SessionDetailsResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          type: object
          properties:
            schema_version:
              type: string
            session_id:
              type: string
            created_at: {}
            expires_at: {}
            committed_at: {}
            processed_at: {}
            status:
              type: string
              nullable: true
            patient_details:
              type: object
              additionalProperties: true
            additional_data:
              type: object
              additionalProperties: true
            audio_matrix:
              type: object
              properties:
                quality:
                  type: number
                  nullable: true
                  description: Overall audio quality score (0–1).
            documents:
              type: array
              items:
                $ref: '#/components/schemas/SessionDocument'
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Machine-readable error code.
              example: invalid_audio_format
            message:
              type: string
              description: Human-readable error message.
              example: Audio format 'audio/mp3' is not supported
            details:
              type: object
              additionalProperties: true
              description: Additional error context.
    SessionDocument:
      type: object
      properties:
        document_id:
          type: string
        session_id:
          type: string
        template_id:
          type: string
        document_name:
          type: string
        type:
          type: string
          description: Document category (`template`, `custom`, `transcript`, ...).
        status:
          type: string
        errors:
          type: array
          items: {}
        warnings:
          type: array
          items: {}
        usage_information:
          type: object
          additionalProperties: true
        publish:
          type: object
          additionalProperties: true
        created_at: {}
        commit_at: {}
        processed_at: {}
        download_url:
          type: string
          nullable: true
          description: Presigned download URL — present when `presigned=true`.
        download_url_expires_at:
          type: integer
          nullable: true
        lang:
          type: string
          nullable: true
  securitySchemes:
    auth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your auth token.

````