---
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}`

## Request

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

## 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
    - `links` object, nullable: Absolute URLs of resources related to this Transcription. Includes `conversation`, the Conversations API resource for this Transcription's `conversationId`, once the transcript has been stored. Omitted entirely when there is no related resource to link to.

## Other responses

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

## Changes

- **2026-10-12** (v3) `df2bdba2dcf0`: 18 breaking
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `400`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `401`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `403`
  - the `detail` response property's minLength was decreased from `16` to `0` for the response status `404`
  - …14 more
- **2026-09-09** (v3) `c98e4be22d70`: 1 info
  - added the optional property `transcription/links` to the response with the `200` status

[Operation history](https://skmtc.dev/twilio/apis/twilio-voice/changes/v3/Transcriptions/:transcriptionId/get.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-voice.md) - [All operations](https://skmtc.dev/twilio/apis/twilio-voice/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-voice/revisions/df2bdba2dcf0?raw)