***

title: transcribe
slug: /reference/python/rest/calling/transcribe
description: Start transcribing speech on an active call via REST.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

Start transcribing speech on an active call. Transcription results are delivered
via events. Returns a `control_id` for stopping the transcription.

<EndpointSchemaSnippet endpoint="POST /api/calling/calls" />

## **Response Example**

<EndpointResponseSnippet endpoint="POST /api/calling/calls" />

## **Example**

```python {9}
from signalwire.rest import RestClient

client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)

result = client.calling.transcribe(
    call_id="call-id-xxx",
)
control_id = result.get("control_id")
```