---
title: "WebSocket Speech-to-Text (Live streaming)"
method: GET
path: "/listen"
tags: ["Speech-to-Text"]
---

# WebSocket Speech-to-Text (Live streaming)

`GET /listen`

## Request

- Base URL: `https://api.munsit.com/api/v1`
- URL: `https://api.munsit.com/api/v1/listen`
- Auth: API key in header `x-api-key`

Real-time Arabic transcription over WebSocket: interim and final results with word timestamps and confidence, turn detection, and per-turn sentiment and speaker gender. Audio is sent as binary frames; controls and events are JSON text frames. The full message contract is in asyncapi.json (channel "listen"). Supersedes the deprecated WS /websocket/speech-to-text.

## Query parameters

- `api_key` string
- `x-api-key` string
- `encoding` 'linear16' | 'mulaw' | 'alaw'
- `sample_rate` 8000 | 16000
- `channels` 1 | 2
- `language` 'auto' | 'ar' | 'en' | 'ar-en'
- `interim_results` boolean
- `endpointing` integer
- `smart_turn` boolean
- `timestamps` boolean
- `hotwords` string
- `correlation_id` string
- `metadata` string

## Changes

- **2026-11-03** `d26f3860be0d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/munsit/apis/munsit-api/changes/listen/get.md)

---

[API](https://skmtc.dev/munsit/apis/munsit-api.md) - [All operations](https://skmtc.dev/munsit/apis/munsit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/munsit/apis/munsit-api/revisions/d26f3860be0d?raw)