Responses are generated using AI and may contain mistakes.
Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to support@bland.ai with questions.
Returns the current state of a translation session — useful for checking whether a session connected, how long it ran, and how many minutes were billed.
Authentication
string
required
Your API key for authentication
Path Parameters
string
required
The session UUID returned by POST /v1/translation/sessions
Response
object
Show data properties
string
Unique identifier for the session
string
One of PENDING (created, WebSocket not yet connected), ACTIVE (audio flowing), ENDED, FAILED, EXPIRED (hit max duration), ABANDONED (never connected before token expiry)
string
Source language code
string
Target language code
string
Voice used for translated speech, or null for the default
string
pcm16 or twilio_ulaw
integer
Inbound sample rate for pcm16 sessions; null for twilio_ulaw
integer
Configured maximum session length
string
Why the session ended: client_disconnect, max_duration, error, or api_terminated. null while the session is pending or active.
number
Connected duration in seconds. null until the session ends.
integer
Billed minutes (session_seconds rounded up to the next minute). null until the session ends.
string
ISO timestamp of session creation
string
ISO timestamp of the WebSocket connection, or null if it never connected
string
ISO timestamp of session end, or null while pending or active