---
title: "List transcripts"
method: GET
path: "/v2/transcript"
tags: ["transcript"]
---

# List transcripts

`GET /v2/transcript`

<Note>To retrieve your transcriptions on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.</Note>
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.

**Pagination**

This endpoint returns paginated results. The response includes a `page_details` object with the following properties:
- `page_details.limit` - Maximum number of transcripts per page.
- `page_details.result_count` - Total number of transcripts returned on the current page.
- `page_details.current_url` - URL to the current page.
- `page_details.prev_url` - URL to the previous page of older transcripts.
- `page_details.next_url` - URL to the next page of newer transcripts.

## Query parameters

- `limit` integer
- `status` 'queued' | 'processing' | 'completed' | 'error' — The status of your transcript. Possible values are queued, processing, completed, or error.
- `created_on` string, date
- `before_id` string, uuid
- `after_id` string, uuid
- `throttled_only` boolean

## Response `200`

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

- TranscriptList — A list of transcripts. Transcripts are sorted from newest to oldest. The previous URL always points to a page with older transcripts.
  - `page_details` PageDetails, required — Details of the transcript page. Transcripts are sorted from newest to oldest. The previous URL always points to a page with older transcripts.
    - `limit` integer, required — The number of results this page is limited to
    - `result_count` integer, required — The actual number of results in the page
    - `current_url` string, url, required — The URL used to retrieve the current page of transcripts
    - `prev_url` string, url, nullable, required — The URL to the next page of transcripts. The previous URL always points to a page with older transcripts.
    - `next_url` string, url, nullable, required — The URL to the next page of transcripts. The next URL always points to a page with newer transcripts.
  - `transcripts` TranscriptListItem[], required — An array of transcripts
    - `id` string, uuid, required — The unique identifier for the transcript
    - `resource_url` string, url, required — The URL to retrieve the transcript
    - `status` 'queued' | 'processing' | 'completed' | 'error', required — The status of your transcript. Possible values are queued, processing, completed, or error.
    - `created` string, required — The date and time the transcript was created
    - `completed` string, nullable, required — The date and time the transcript was completed
    - `audio_url` string, url, required — The URL to the audio file
    - `error` string, nullable, required — Error message of why the transcript failed

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `429` — Too many requests
- `500` — An error occurred while processing the request
- `503` — Service unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/assemblyai/apis/assemblyai-api.md) · [All operations](https://skmtc.net/assemblyai/apis/assemblyai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/assemblyai/assemblyai-api/revisions/f743e2ea9459/schema)