Sign in
V3Transcriptions

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

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.

get/v3/Transcriptions

Query parameters

createdAfterstring date-time
Example:2026-01-01T00:00:00Z

Only include transcriptions created at or after this time (inclusive)

createdBeforestring date-time
Example:2026-02-01T00:00:00Z

Only include transcriptions created strictly before this time (exclusive)

languageCodestring
Example:en-US

Only include transcriptions whose resolved language matches this value exactly. The comparison is case sensitive, so use the stored form, for example en-US.

sourceIdstring
Example:REe3a2b046e52271b586425c61d84ca90e

Only include transcriptions for this source audio. Must be a Recording SID in lowercase hex; anything else is rejected with a 400.

status'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED'
Example:COMPLETED

Only include transcriptions in this status

pageSizeinteger
Example:50

Number of results per page. This endpoint caps at 100, which is lower than the shared pagination component's ceiling and matches what the service enforces.

pageTokenstring
Example:aWQ9dm9pY2VfdHJhbnNjcmlwdGlvbl83bjdobmQ3c2Y2OHlmdjVyZTQybnZ2ejdhYSZjcmVhdGVkQXQ9MjAyNi0wNC0wMlQxOToyNToyMC4wMDBaJl9fc2Y9MA

Opaque cursor for retrieving the next or previous page of results

Response

A page of transcriptions matching the given filters

Example response

{
  "transcriptions": [
    {
      "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