---
title: "Fetch metadata about a specific transcription"
method: GET
path: "/v3/Transcriptions/{transcriptionId}"
tags: ["V3Transcriptions"]
---

# Fetch metadata about a specific transcription

`GET /v3/Transcriptions/{transcriptionId}`

## Path parameters

- `transcriptionId` string, required

## Response `200`

Success

- VoiceV3TranscriptionLongRunningOperationResponse — Status response for a transcription operation. Returns the current state of the operation along with the full transcription resource. Poll this response to track progress from acceptance through to completion or failure.
  - `operationId` string, 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.
  - `statusUrl` string, uri, required — URL to poll for the latest operation status.
  - `transcription` VoiceV3TranscriptionTranscription, required
    - `id` string, required — Unique identifier for a Transcription. This is also the transcriptionId returned in the LRO 202 response.
    - `accountId` string, required — Twilio Account SID
    - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED', required — The current status of the transcription operation
    - `transcriptionConfigurationId` string, required — Unique identifier for a Transcription configuration.
    - `mediaUrl` string, uri, nullable — The third party media URL
    - `sourceId` string, nullable — The source ID (recording ID) - used for tracking only
    - `audioStartedAt` string, date-time — The call/recording start time. When the transcription was created using a sourceId, this value is inferred from the recording resource's start time. When created using a mediaUrl, this reflects the value supplied by the caller.
    - `conversationId` string, nullable — Maestro conversation ID, populated once the transcription has been stored in Maestro.
    - `participants` VoiceV3TranscriptionParticipant[] — Array of participants in the conversation
      - `type` 'CUSTOMER' | 'HUMAN_AGENT' | 'AI_AGENT' — The role of this participant in the conversation.
      - `address` string — The phone number or identifier for this participant (E.164 format for phone numbers). Used to correlate this participant with their profile and conversation history.
      - `name` string — User-defined name for this participant
      - `audioChannelIndex` integer, required — One-based index of the audio channel in a multi-channel recording
    - `duration` integer, nullable — Audio duration in seconds
    - `resolvedConfiguration` VoiceV3TranscriptionResolvedConfiguration
      - `transcriptionEngine` string — The engine used for transcription (Deepgram, Google, or auto)
      - `speechModel` string — The speech model used for transcription (e.g., nova-2, nova-3, chirp_2)
      - `language` string — The language code for transcription
      - `transcriptionStatusCallback` VoiceV3TranscriptionTranscriptionStatusCallback
        - `url` string, uri — The URL to call when transcription status changes
        - `method` 'POST' — The HTTP method to use for the callback, currently only POST is supported
        - `events` string[], nullable — The transcription events that will trigger the callback
      - `conversationConfigurationId` string, nullable — Maestro conversation configuration ID
      - `participantDefaults` object[] — Default participant configurations for the transcription
        - `audioChannelIndex` integer, required — One-based index of the audio channel
        - `type` 'CUSTOMER' | 'HUMAN_AGENT' | 'AI_AGENT', required — The participant role type
    - `createdAt` string, date-time, required — When this transcript was created
    - `updatedAt` string, date-time, required — When this transcript was last updated
    - `url` string, uri, required — The URL of this resource

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/twilio/apis/voice-v3.md) · [All operations](https://skmtc.net/twilio/apis/voice-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/voice-v3/versions/77f2598e78ea/schema)