> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Translation Session

> Retrieve the status, duration, and billing details of a translation session

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

**authorization** `string` *required*

Your API key for authentication

## Path Parameters

**session\_id** `string` *required*

The session UUID returned by `POST /v1/translation/sessions`

## Response

**data** `object`

**data properties**

**session\_id** `string`

Unique identifier for the session

**status** `string`

One of `PENDING` (created, WebSocket not yet connected), `ACTIVE` (audio flowing), `ENDED`, `FAILED`, `EXPIRED` (hit max duration), `ABANDONED` (never connected before token expiry)

**source\_language** `string`

Source language code

**target\_language** `string`

Target language code

**voice\_id** `string`

Voice used for translated speech, or `null` for the default

**audio\_protocol** `string`

`pcm16` or `twilio_ulaw`

**sample\_rate** `integer`

Inbound sample rate for `pcm16` sessions; `null` for `twilio_ulaw`

**max\_duration\_seconds** `integer`

Configured maximum session length

**end\_reason** `string`

Why the session ended: `client_disconnect`, `max_duration`, `error`, or `api_terminated`. `null` while the session is pending or active.

**session\_seconds** `number`

Connected duration in seconds. `null` until the session ends.

**billable\_minutes** `integer`

Billed minutes (`session_seconds` rounded up to the next minute). `null` until the session ends.

**created\_at** `string`

ISO timestamp of session creation

**started\_at** `string`

ISO timestamp of the WebSocket connection, or `null` if it never connected

**ended\_at** `string`

ISO timestamp of session end, or `null` while pending or active

**errors** `array` (default: null)

Array of error objects if the request failed

```bash cURL theme={null}
curl "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python Python theme={null}
import requests

response = requests.get(
    "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json()["data"]["status"])
```

```json Ended Session theme={null}
{
  "data": {
    "session_id": "9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    "status": "ENDED",
    "source_language": "en",
    "target_language": "es",
    "voice_id": null,
    "audio_protocol": "pcm16",
    "sample_rate": 16000,
    "max_duration_seconds": 1800,
    "end_reason": "client_disconnect",
    "session_seconds": 19.712,
    "billable_minutes": 1,
    "created_at": "2026-06-04T18:05:07.885Z",
    "started_at": "2026-06-04T18:05:08.861Z",
    "ended_at": "2026-06-04T18:05:28.573Z"
  },
  "errors": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.