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
}