---
title: "Get Session"
method: GET
path: "/voice/v1/sessions/{session_id}"
tags: ["protocol"]
---

# Get Session

`GET /voice/v1/sessions/{session_id}`

Retrieve the current status of a session and, once processing finishes, its transcript and structured template results. The **HTTP status code** signals progress: `202` still processing, `200` completed, `206` completed with partial results, `410` expired, `404` not found. After calling End Session, poll this endpoint at ~1-second intervals until the status is no longer `202`.

## Path parameters

- `session_id` string, required

## Query parameters

- `document_id` string

## Response `200`

Session completed successfully

- SessionCompletedResponse — Returned with HTTP 200 when the session completed successfully.
  - `session_id` string
  - `upload_url` string — Audio upload URL for the session (HTTPS for chunked, wss:// for stream).
  - `status` string
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `model_used` string, nullable
  - `language_detected` string, nullable — ISO 639-1 language code detected from the audio.
  - `audio_files_received` integer
  - `audio_files` string[]
  - `additional_data` object
  - `templates` object[] — Template results as a **list** — one entry per generated document, each a single-key object keyed by `template_id`. A template that produces multiple documents appears multiple times, so this is a list rather than a map. Each inner object carries `status`, `data`, `document_id`, `document_type`, `publish` metadata (and a `presigned_url` when applicable).
  - `transcript` string, nullable
  - `patient_details` object, nullable

## Other responses

- `202` — Session still processing — keep polling
- `206` — Session completed with partial results
- `404` — Session not found
- `410` — Session expired before processing was initiated

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)