> ## 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.

# End Translation Session

> Terminate a translation session from the server side

Ends a translation session. If the WebSocket is connected, it receives a final `session_ended` control message and is closed. Pending sessions (created but never connected) are also cleaned up — useful for releasing a concurrency slot you no longer need.

Terminating an already-ended session is a no-op and returns the session's final state.

## Authentication

**authorization** `string` *required*

Your API key for authentication

## Path Parameters

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

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

## Body Parameters

**reason** `string`

Optional context (max 200 characters) recorded with the session's `end_reason` as `api_terminated:<reason>`.

## Response

Returns the same session object as [Get Translation Session](https://docs.bland.ai/api-v1/get/translation-sessions-id.md), with `status` and `end_reason` reflecting the termination.

```bash cURL theme={null}
curl -X DELETE "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.delete(
    "https://api.bland.ai/v1/translation/sessions/9592342c-0ed2-4c5e-8ceb-16aa55c804a7",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json()["data"]["end_reason"])  # "api_terminated"
```

```json Terminated 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": "api_terminated",
    "session_seconds": null,
    "billable_minutes": null,
    "created_at": "2026-06-04T18:05:07.885Z",
    "started_at": null,
    "ended_at": "2026-06-04T18:06:08.684Z"
  },
  "errors": null
}
```


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