Recording Transcription

A Transcription represents the transcribed text and metadata from a transcribed recording of a voice call.

The transcription text itself is the result of converting an audio recording to readable text. To generate transcriptions from call recordings, use the TwiML <Record> verb and set transcribe="true".

Your account will be charged if you request transcription for a recording, as this is a paid feature. Additionally, transcription is currently limited to recordings at most two minutes in length.

For pricing information, see the transcriptions pricing page.

Transcription properties

`account_sid`	sid<AC> Not PII The unique id of the Account responsible for this transcription.
`date_created`	date_time<rfc2822> Not PII The date that this resource was created, in RFC 2822 format.
`date_updated`	date_time<rfc2822> Not PII The date that this resource was last updated, in RFC 2822 format.
`duration`	string Not PII The duration of the transcribed audio, in seconds.
`price`	decimal Not PII The charge for this transcript in the currency associated with the account. Populated after the transcript is complete. Note, this value may not be immediately available.
`price_unit`	currency Not PII The currency in which `Price` is measured, in ISO 4127 format (e.g. `usd`, `eur`, `jpy`).
`recording_sid`	sid<RE> Not PII The unique id of the Recording that created this Transcription.
`sid`	sid<TR> Not PII A unique 34-character string that identifies this resource.
`status`	enum:status Not PII A string representing the status of the transcription: `in-progress`, `completed` or `failed`.
`transcription_text`	string PII MTL: 30 DAYS The text content of the transcription.
`uri`	uri Not PII The URI for this resource, relative to `https://api.twilio.com`

Fetch a Transcription resource

get

https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions/{Sid}.json

Twilio will respond with the JSON metadata for the Transcription. If you append ".txt" to the end of the Transcription resource's URI, Twilio will return only the text of the transcription:

/2010-04-01/Accounts/{AccountSid}/Transcriptions/{TranscriptionSid}.txt

Parameters

Sid

Required

get sid<TR> Not PII

The unique SID that identifies this Transcription

Example 1

Loading Code Sample...

Next Sample

Show Output

Output

Fetch a specific Transcription

Read multiple Transcription resources

get

https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Transcriptions.json

Returns the full set of Transcriptions generated from all recordings in an account.

The list Twilio returns includes paging information.

Example 1

Loading Code Sample...

Next Sample

Show Output

Output

Read: List all Transcriptions

You can also access a full list of Transcriptions directly from a given Recording by passing the RecordingSid to the Recording resource:

/2010-04-01/Accounts/{YourAccountSid}/Recordings/{RecordingSid}/Transcriptions.json

The cURL command to fetch Transcriptions from a Recording looks like this:

curl -G https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings/REXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Transcriptions.json \
-u 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_auth_token'

If you prefer that Twilio responds with XML, change .json to .xml.