Get a session

Returns one session including its token, so a server that stored only the id can recover the token. A session that belongs to another account is reported as not found.

Responses
200 Session. Schema — OPTIONAL ok boolean Possible values: [true] data object id string Session identifier. Use it to inspect, revoke and report on the session. token string — OPTIONAL Credential the end user connects with. Returned by POST /v2/sessions and GET /v2/sessions/{id} only. intent string Possible values: [s2s, stt, tts] Product the session token is valid for: s2s: speech-to-speech translation stt: speech-to-text tts: text-to-speech A token presented to a different product is refused. connection_type string Possible values: [ws, webrtc] Transport the end user will connect with. webrtc is available for s2s only. A token issued for one transport cannot be used with the other. single_use boolean true if the token opens only one stream in its lifetime. client_reference_id string — OPTIONAL Possible values: length ≤ 256 Your identifier from the create request. status string Possible values: [pending, active, idle, used, expired, revoked] pending: issued, no stream opened yet, connect window still open active: at least one stream is running idle: reusable token that has been used before, no stream running, connect window still open used: single-use token whose stream has finished; cannot be used again expired: connect window has passed and no stream is running revoked: revoked by you created_at date-time When the session was created. connect_by date-time Moment after which the token can no longer open a new stream. max_session_duration_seconds integer — OPTIONAL Duration cap applied to each stream, if one was set. first_connected_at date-time — OPTIONAL When the first stream was opened with this token, or null if none yet. active_stream_count integer Number of streams running with this token. webrtc object — OPTIONAL Present for connection_type: webrtc only. url string WebRTC endpoint the publisher and listeners connect to. room_name string Room the session runs in. subscriber_keys string[] — OPTIONAL Listener tokens, one per requested subscriber. Returned on creation only.
401
404
500