---
title: "Gets a list of transcriptions for the authenticated subscription."
method: GET
path: "/transcriptions"
tags: ["Custom Speech transcriptions:"]
---

# Gets a list of transcriptions for the authenticated subscription.

`GET /transcriptions`

## Query parameters

- `skip` integer
- `top` integer
- `filter` string

## Response `200`

OK

- PaginatedTranscriptions
  - `values` Transcription[] — A list of entities limited by either the passed query parameters 'skip' and 'top' or their default values. When iterating through a list using pagination and deleting entities in parallel, some entities will be skipped in the results. It's recommended to build a list on the client and delete after the fetching of the complete list.
    - `links` TranscriptionLinks
      - `files` string, uri — The location to get all files of this entity. See operation "Transcriptions_ListFiles" for more details.
    - `properties` TranscriptionProperties
      - `wordLevelTimestampsEnabled` boolean — A value indicating whether word level timestamps are requested. The default value is `false`.
      - `displayFormWordLevelTimestampsEnabled` boolean — A value indicating whether word level timestamps for the display form are requested. The default value is `false`.
      - `duration` string — The duration of the transcription. The duration is encoded as ISO 8601 duration ("PnYnMnDTnHnMnS", see https://en.wikipedia.org/wiki/ISO_8601#Durations).
      - `channels` integer[] — A collection of the requested channel numbers. In the default case, the channels 0 and 1 are considered.
      - `destinationContainerUrl` string, uri — The requested destination container. ### Remarks ### When a destination container is used in combination with a `timeToLive`, the metadata of a transcription will be deleted normally, but the data stored in the destination container, including transcription results, will remain untouched, because no delete permissions are required for this container.<br /> To support automatic cleanup, either configure blob lifetimes on the container, or use "Bring your own Storage (BYOS)" instead of `destinationContainerUrl`, where blobs can be cleaned up.
      - `punctuationMode` 'None' | 'Dictated' | 'Automatic' | 'DictatedAndAutomatic' — The mode used for punctuation.
      - `profanityFilterMode` 'None' | 'Removed' | 'Tags' | 'Masked' — Mode of profanity filtering.
      - `timeToLive` string — How long the transcription will be kept in the system after it has completed. Once the transcription reaches the time to live after completion (successful or failed) it will be automatically deleted. Not setting this value or setting it to 0 will disable automatic deletion. The longest supported duration is 31 days. The duration is encoded as ISO 8601 duration ("PnYnMnDTnHnMnS", see https://en.wikipedia.org/wiki/ISO_8601#Durations).
      - `email` string — The email address to send email notifications to in case the operation completes. The value will be removed after successfully sending the email.
      - `error` EntityError
        - `code` string — The code of this error.
        - `message` string — The message for this error.
      - `diarizationEnabled` boolean — A value indicating whether diarization (speaker identification) is requested. The default value is `false`. If this field is set to true and the improved diarization system is configured by specifying `DiarizationProperties`, the improved diarization system will provide diarization for a configurable range of speakers. If this field is set to true and the improved diarization system is not enabled (not specifying `DiarizationProperties`), the basic diarization system will distinguish between up to two speakers. No extra charges are applied for the basic diarization. The basic diarization system is deprecated and will be removed in the next major version of the API. This `diarizationEnabled` setting will also be removed.
      - `diarization` DiarizationProperties
        - `speakers` DiarizationSpeakersProperties, required
          - `minCount` integer — A hint for the minimum number of speakers for diarization. Must be smaller than or equal to the maxSpeakers property.
          - `maxCount` integer — The maximum number of speakers for diarization. Must be less than 36 and larger than or equal to the minSpeakers property.
      - `languageIdentification` LanguageIdentificationProperties
        - `mode` 'Continuous' | 'Single' — The mode used for language identification.
        - `candidateLocales` string[], required — The candidate locales for language identification (example ["en-US", "de-DE", "es-ES"]). A minimum of 2 and a maximum of 10 candidate locales, including the main locale for the transcription, is supported.
        - `speechModelMapping` object — An optional mapping of locales to speech model entities. If no model is given for a locale, the default base model is used. Keys must be locales contained in the candidate locales, values are entities for models of the respective locales.
    - `self` string, uri — The location of this entity.
    - `model` EntityReference
      - `self` string, uri, required — The location of the referenced entity.
    - `dataset` EntityReference
      - `self` string, uri, required — The location of the referenced entity.
    - `contentUrls` string[] — A list of content urls to get audio files to transcribe. Up to 1000 urls are allowed. This property will not be returned in a response.
    - `contentContainerUrl` string, uri — A URL for an Azure blob container that contains the audio files. A container is allowed to have a maximum size of 5GB and a maximum number of 10000 blobs. The maximum size for a blob is 2.5GB. Container SAS should contain 'r' (read) and 'l' (list) permissions. This property will not be returned in a response.
    - `locale` string, required — The locale of the contained data. If Language Identification is used, this locale is used to transcribe speech for which no language could be detected.
    - `displayName` string, required — The display name of the object.
    - `description` string — The description of the object.
    - `customProperties` object — The custom properties of this entity. The maximum allowed key length is 64 characters, the maximum allowed value length is 256 characters and the count of allowed entries is 10.
    - `project` EntityReference
      - `self` string, uri, required — The location of the referenced entity.
    - `lastActionDateTime` string, date-time — The time-stamp when the current status was entered. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
    - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' — Describe the current state of the API
    - `createdDateTime` string, date-time — The time-stamp when the object was created. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
  - `@nextLink` string, uri — A link to the next set of paginated results if there are more entities available; otherwise null.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-speech-speechtotext.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-speech-speechtotext/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-speech-speechtotext/versions/931821089e0d/schema)