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:

Status	Description	Constraints
limit	Limits the number of results to return in a single response	Must be between 1 and 200, inclusive, with a default value of 10
status	Filters transcripts by their status	Must be one of the following values: queued, processing, completed, or error
created_on	Returns only transcripts that were created on a specific date	Must be in the format YYYY-MM-DD
before_id	Returns transcripts that were created before a specific transcript ID	Must be a valid transcript ID
after_id	Returns transcripts that were created after a specific transcript ID	Must be a valid transcript ID
throttled_only	Returns only throttled transcripts, regardless of their status	Must 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:

Status	Description
id	The ID of the transcript.
resource_url	The URL to fetch the complete information for this transcript.
status	The current status of the transcript.
created	The date and time the transcript was created.
completed	The date and time the transcript was completed, if applicable.
audio_url	The 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.