Skip to main content
GET
/
v1
/
sessions
/
{id}
curl https://api.kallglot.com/v1/sessions/sess_01HXYZ123456789 \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "id": "sess_01HXYZ123456789",
  "object": "session",
  "status": "active",
  "mode": "bidirectional_translation",
  "source_language": "de",
  "target_language": "en",
  "stream": {
    "url": "wss://stream.kallglot.com/v1/sessions/sess_01HXYZ123456789/connect",
    "token": "kst_live_xxxxxxxxxxxxxxxx",
    "expires_at": "2026-03-26T12:00:00Z"
  },
  "provider": {
    "type": "twilio",
    "phone_number": "+14155551234",
    "status": "connected",
    "call_sid": "CA1234567890abcdef"
  },
  "duration": 125.5,
  "recording": {
    "enabled": true
  },
  "transcript": {
    "available": true,
    "word_count": 342
  },
  "metadata": {
    "customer_id": "cust_123"
  },
  "created_at": "2026-03-26T11:00:00Z",
  "started_at": "2026-03-26T11:00:15Z",
  "ended_at": null
}
Retrieve the details of an existing session by its ID. This endpoint returns the current state of the session including status, duration, and associated resources.

​
Path Parameters

​
id
string
required
The unique session identifier (e.g., sess_01HXYZ123456789).

​
Response

​
id
string
Unique session identifier.
​
object
string
Always session.
​
status
string
Current session status:
  • created - Session created, not yet connected
  • connecting - Establishing provider connection
  • active - Session is active and processing
  • ended - Session has ended
​
mode
string
Session mode: bidirectional_translation, assistive_translation, ai_agent, or help_chat_voice.
​
source_language
string
Input language code.
​
target_language
string
Output language code.
​
stream
object
WebSocket connection details. Only present if session is not ended.
​
provider
object
Provider connection details.
​
duration
number
Session duration in seconds. For active sessions, this is the current duration.
​
recording
object
Recording information.
​
transcript
object
Transcript summary. Full transcript available via the transcript endpoint.
​
metadata
object
Custom metadata attached to the session.
​
created_at
string
Creation timestamp (ISO 8601).
​
started_at
string
When the session became active (ISO 8601). Null if not yet started.
​
ended_at
string
When the session ended (ISO 8601). Null if still active.
curl https://api.kallglot.com/v1/sessions/sess_01HXYZ123456789 \
  -H "Authorization: Bearer sk_live_your_api_key"

{
  "id": "sess_01HXYZ123456789",
  "object": "session",
  "status": "active",
  "mode": "bidirectional_translation",
  "source_language": "de",
  "target_language": "en",
  "stream": {
    "url": "wss://stream.kallglot.com/v1/sessions/sess_01HXYZ123456789/connect",
    "token": "kst_live_xxxxxxxxxxxxxxxx",
    "expires_at": "2026-03-26T12:00:00Z"
  },
  "provider": {
    "type": "twilio",
    "phone_number": "+14155551234",
    "status": "connected",
    "call_sid": "CA1234567890abcdef"
  },
  "duration": 125.5,
  "recording": {
    "enabled": true
  },
  "transcript": {
    "available": true,
    "word_count": 342
  },
  "metadata": {
    "customer_id": "cust_123"
  },
  "created_at": "2026-03-26T11:00:00Z",
  "started_at": "2026-03-26T11:00:15Z",
  "ended_at": null
}