v1

latestOpenAPI 3.0.1Proprietary and protectedraw.githubusercontent.com2026-05-062893.1 KB

V3Transcriptions

Fetch metadata about a specific transcription

get/v3/Transcriptions/{transcriptionId}

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": "RExxxxx",
    "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"
  }
}

All 2 operations