---
title: "Transcript status callback"
method: POST
path: "transcribeStatusCallback"
tags: ["Calls"]
---

# Transcript status callback

`POST transcribeStatusCallback` (webhook)

Sent to your `status_url` when the call's transcription is ready.
`calling.transcript.completed` includes the transcribed text;
`calling.transcript.failed` means the call could not be transcribed.

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See [Status callback reliability](/docs/platform/webhooks#status-callback-reliability).

## Payload

- object — Sent to your `status_url` when the call's transcription is ready. `calling.transcript.completed` includes the transcribed text; `calling.transcript.failed` means the call could not be transcribed. Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See [Status callback reliability](/docs/platform/webhooks#status-callback-reliability).
  - `event_type` 'calling.transcript.completed' | 'calling.transcript.failed', required — Whether the transcription completed or failed.
  - `timestamp` number, required — When the event was sent, as a Unix timestamp in seconds.
  - `project_id` string, uuid, required — Your project ID.
  - `space_id` string, uuid, required — Your Space ID.
  - `params` object, required — The transcript.
    - `id` string, uuid, required — Unique ID for this transcript.
    - `call_id` string, uuid, required — ID of the call that was transcribed.
    - `segment_id` string, uuid, required — ID of the call leg that was transcribed.
    - `text` string — The transcribed text of the call. Omitted when there is no transcribed text.

## Acknowledgement `200`

Webhook received

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)