Skip to main content

Listing and deleting transcripts

Listing historical transcripts

To retrieve a list of transcripts, make a request to the endpoint /v2/transcript, with the following query parameters:

limitLimits the number of results to return in a single responseMust be between 1 and 200, inclusive, with a default value of 10
statusFilters transcripts by their statusMust be one of the following values: queued, processing, completed, or error
created_onReturns only transcripts that were created on a specific dateMust be in the format YYYY-MM-DD
before_idReturns transcripts that were created before a specific transcript IDMust be a valid transcript ID
after_idReturns transcripts that were created after a specific transcript IDMust be a valid transcript ID
throttled_onlyReturns only throttled transcripts, regardless of their statusMust be either true or false

For example, to retrieve the most recent 200 completed transcripts, you can make the following cURL request:

curl --request GET \
--url https://api.assemblyai.com/v2/transcript?limit=200&status=completed \
--header 'authorization: {your_token}'

The API response contains an array of objects under the transcripts key, with each object representing a transcript and containing the following information:

idThe ID of the transcript.
resource_urlThe URL to fetch the complete information for this transcript.
statusThe current status of the transcript.
createdThe date and time the transcript was created.
completedThe date and time the transcript was completed, if applicable.
audio_urlThe audio URL that was submitted in the initial POST request when creating the transcript.

Note that if you delete a transcript, the audio URL will no longer be available via the historical endpoint, and the audio_url key will show "deleted by user".

Paginating the results

The API only returns a maximum of 200 transcripts per response. To navigate to the next page of results, you can use the prev_url value from the page_details object of your initial request. You can make the same API call as before, replacing the URL with the prev_url.

Note that transcripts are listed from newest to oldest, so prev_url always points to the prior page of older transcripts.

Deleting transcripts from the API

By default, AssemblyAI doesn't store a copy of the files you submit to the API for transcription. However, the transcription itself is stored in our encrypted database so that we can serve it to you and your application.

Once a transcript is deleted, all sensitive information associated with it'll be permanently deleted from our system. However, certain metadata such as the transcript ID and audio duration remain stored for billing purposes.

Please exercise caution when deleting transcripts, as this action can't be undone. If you have any questions, please contact our support team for assistance.