List transcripts

1 curl https://api.assemblyai.com/v2/transcript \ 2 -H "Authorization: <Authorization>"

1 { 2 "page_details": { 3 "limit": 3, 4 "result_count": 3, 5 "current_url": "https://api.assemblyai.com/v2/transcript?limit=3", 6 "prev_url": "https://api.assemblyai.com/v2/transcript?limit=3&before_id=28a73d01-98db-41dd-9e98-2533ba0af117", 7 "next_url": "https://api.assemblyai.com/v2/transcript?limit=3&after_id=b33f4691-85b7-4f31-be12-a87cef1c1229" 8 }, 9 "transcripts": [ 10 { 11 "id": "b33f4691-85b7-4f31-be12-a87cef1c1229", 12 "resource_url": "https://api.assemblyai.com/v2/transcript/b33f4691-85b7-4f31-be12-a87cef1c1229", 13 "status": "completed", 14 "created": "2024-03-11T21:29:59.936851", 15 "audio_url": "http://deleted_by_user", 16 "completed": "2024-03-11T21:30:07.314223", 17 "error": null 18 }, 19 { 20 "id": "ce522f10-d204-42e8-a838-6b95098145cc", 21 "resource_url": "https://api.assemblyai.com/v2/transcript/ce522f10-d204-42e8-a838-6b95098145cc", 22 "status": "error", 23 "created": "2024-03-11T21:23:59.979420", 24 "audio_url": "https://storage.googleapis.com/client-docs-samples/nbc.oopsie", 25 "completed": "foo", 26 "error": "Download error, unable to download https://storage.googleapis.com/client-docs-samples/nbc.oopsie. Please make sure the file exists and is accessible from the internet." 27 }, 28 { 29 "id": "28a73d01-98db-41dd-9e98-2533ba0af117", 30 "resource_url": "https://api.assemblyai.com/v2/transcript/28a73d01-98db-41dd-9e98-2533ba0af117", 31 "status": "completed", 32 "created": "2024-03-11T21:12:57.372215", 33 "audio_url": "https://assembly.ai/nbc.mp3", 34 "completed": "2024-03-11T21:13:03.267020", 35 "error": null 36 } 37 ] 38 }

To retrieve your transcriptions on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com.

Retrieve a list of transcripts you created. Transcripts are sorted from newest to oldest and can be retrieved for the last 90 days of usage. The previous URL always points to a page with older transcripts.

If you need to retrieve transcripts from more than 90 days ago please reach out to our Support team at support@assemblyai.com.

Query parameters

limitanyOptional

Maximum amount of transcripts to retrieve

statusenumOptional

Filter by transcript status

Allowed values:

created_onanyOptional

Only get transcripts created on this date

before_idanyOptional

Get transcripts that were created before this transcript ID

after_idanyOptional

Get transcripts that were created after this transcript ID

throttled_onlyanyOptional

Only get throttled transcripts, overrides the status filter

Response

A list of transcripts. Transcripts are sorted from newest to oldest. The previous URL always points to a page with older transcripts.

page_detailsobject

Details of the transcript page

transcriptslist of objects

An array of transcripts

Headers

Query parameters

Response

Errors