Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/Transcriptions/{Sid}.json

Retrieve a transcription

Retrieves one transcription resource from an account. Use AccountSid and Sid to identify the owning account and transcription, then inspect the transcription status and text when available. The response includes recording, pricing, timing, and transcription details.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
AccountSidstringrequired
The unique identifier of the account that created the transcription. Must be a 34-character SID beginning with `AC`.
Sidstringrequired
The unique identifier of the transcription resource to retrieve. Must be a 34-character SID beginning with `TR`.

1 status code
200Returns the transcription object, including its account and recording identifiers, API version, timestamps, duration, price and currency, status, transcription text, type, and resource URI.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Transcription resource.
api_versionstringoptional
The API version used to create the transcription.
date_createdstringoptional
The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
durationstringoptional
The duration of the transcribed audio in seconds.
pricenumberoptional
The charge for the transcript in the currency associated with the account. This value is populated after the transcript is complete so it may not be available immediately.
price_unitstringoptional
The currency in which `price` is measured, in [ISO 4127](https://www.iso.org/iso/home/standards/currency_codes.htm) format (e.g. `usd`, `eur`, `jpy`).
recording_sidstringoptional
The SID of the [Recording](https://www.twilio.com/docs/voice/api/recording) from which the transcription was created.
sidstringoptional
The unique string that that we created to identify the Transcription resource.
statusstringoptional
The status of the transcription. Can be: `in-progress`, `completed`, `failed`.
Allowed:in-progresscompletedfailed
transcription_textstringoptional
The text content of the transcription.
typestringoptional
The transcription type. Can only be: `fast`.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.

Error handling

AccountSid must be a 34-character account SID beginning with AC, and Sid must be a 34-character transcription SID beginning with TR. The transcription status can be in-progress, completed, or failed, and the transcript price may be unavailable until processing is complete.