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:
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:
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.