---
title: "Retrieves a paginated, filterable list of transcriptions for the account, sorted by creation date (newest first)."
method: GET
path: "/v3/Transcriptions"
tags: ["V3Transcriptions"]
---

# Retrieves a paginated, filterable list of transcriptions for the account, sorted by creation date (newest first).

`GET /v3/Transcriptions`

Returns the account's transcriptions, newest first. Filters combine with AND, and paging uses the opaque cursors in meta rather than page numbers: pass meta.nextToken to advance and meta.previousToken to go back. A token is only valid for the filter set that produced it, so changing sourceId or the date range means starting a new walk.
Items are the transcription resource itself. Create and fetch-by-id return the long running operation envelope instead, because creation is asynchronous.

## Query parameters

- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `languageCode` string
- `sourceId` string
- `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED'
- `pageSize` integer
- `pageToken` string

## Response `200`

A page of transcriptions matching the given filters

- VoiceV3TranscriptionTranscriptionList
  - `transcriptions` VoiceV3TranscriptionTranscription[], required — List of transcription resources
    - `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
  - `meta` object, required
    - `key` string, required — A key, sibling to the `meta` object that holds the actual list of resources
    - `pageSize` integer, required — The actual number of resources returned in the response
    - `previousToken` string
    - `nextToken` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Returned only when filtering by sourceId whose total historical item count exceeds the service's scan cap. This is a fixed data volume limit on that one source rather than a problem with the request, so narrowing the other filters or retrying will not help. Error code 17535.
- `429` — Too Many Requests
- `500` — Internal Server Error

## Changes

- **2026-08-25** (v3) `72430bdc1e77` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/twilio/apis/twilio-voice/changes/v3/Transcriptions/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-service-production.skmtc.workers.dev/v1/apis/twilio/twilio-voice/revisions/72430bdc1e77/schema)
