V3Transcriptions

Fetch metadata about a specific transcription

Changed on Oct 12, 2026

get/v3/Transcriptions/{transcriptionId}

Request

Base URL
https://voice.twilio.com
URL
https://voice.twilio.com/v3/Transcriptions/{transcriptionId}
Auth
HTTP basic

Path parameters

transcriptionIdstring required

Example:voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1

The unique identifier of the transcription to fetch

Response

Success

operationIdstring required

Unique identifier for the transcription operation.

status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' required

Current status of the transcription operation. PENDING: accepted but not yet started. RUNNING: currently in progress. COMPLETED: successfully completed. FAILED: failed and cannot be completed.

statusUrlstring uri required

URL to poll for the latest operation status.

Example response

{
  "operationId": "voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1",
  "status": "RUNNING",
  "statusUrl": "https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1",
  "transcription": {
    "id": "voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1",
    "accountId": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "status": "PENDING",
    "transcriptionConfigurationId": "voice_transcriptionconfiguration_5pe8jw3ahdmsh7zr06yh4d45x1",
    "mediaUrl": "http://mymedia.com",
    "sourceId": "REe3a2b046e52271b586425c61d84ca90e",
    "audioStartedAt": "2025-11-19T19:42:16Z",
    "conversationId": "conv_conversation_01k1etx3jbfx88476ccja0889c",
    "participants": [
      {
        "type": "CUSTOMER",
        "address": "+15551234567",
        "name": "Jane Doe",
        "audioChannelIndex": 1
      }
    ],
    "duration": 1000,
    "resolvedConfiguration": {
      "transcriptionEngine": "deepgram",
      "speechModel": "nova-3",
      "language": "multi",
      "transcriptionStatusCallback": {
        "url": "https://example.com/transcriptions/default-webhook",
        "method": "POST",
        "events": [
          "COMPLETED"
        ]
      },
      "conversationConfigurationId": "conv_configuration_01k1etx3jbfx88476ccja0889c",
      "participantDefaults": [
        {
          "audioChannelIndex": 1,
          "type": "CUSTOMER"
        }
      ]
    },
    "createdAt": "2025-11-19T19:42:16Z",
    "updatedAt": "2025-11-19T19:42:16Z",
    "url": "https://voice.twilio.com/v3/Transcriptions/voice_transcription_5pe8jw3ahdmsh7zr06yh4d45x1"
  }
}

Changes

Oct 12, 2026v3df2bdba2dcf0 Revision changes
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the // response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
- breaking
  the response property's minLength was decreased from 16 to 0 for the response status
Sep 9, 2026v3c98e4be22d70 Revision changes
- info
  added the optional property / to the response with the status

Operation history