---
title: "List transcriptions"
method: GET
path: "/transcriptions"
tags: ["Transcriptions"]
---

# List transcriptions

`GET /transcriptions`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/transcriptions`
- Auth: API key in header `X-Api-Key`

Returns a paginated list of the workspace's transcription jobs, newest first.

## Query parameters

- `page` number: Page number (default: 1)
- `limit` number: Items per page (default: 20, max: 100)

## Response `200`

Response for status 200

- object
  - `transcriptions` object[], required
    - `id` string, required: Unique transcription job ID
    - `media_id` string, required: The uploaded media this job transcribed. Reuse it to re-run the same file.
    - `title` string, required: Job title, derived from the uploaded file name
    - `duration_seconds` number, required: Measured duration of the audio, in seconds. This is what was billed.
    - `status` 'processing' | 'ready' | 'failed' | 'no_speech', required
    - `language` string, nullable, required: Detected (or pinned) spoken language as a BCP-47-ish code, e.g. `pt`
    - `speaker_labels` boolean, required: `true` if this job was billed with speaker identification
    - `speaker_count` number, nullable, required: Distinct speakers found. Only populated when `speaker_labels` is `true`.
    - `credits_charged` number, required: Credits actually debited for this job. `0` when nothing was charged, including while the workspace has unlimited usage
    - `media_type` 'image' | 'video' | 'audio' | 'font', required
    - `created_at` string, required: ISO 8601 timestamp of when the job was created
    - `completed_at` string, nullable, required: ISO 8601 timestamp of when the job reached a terminal status
  - `pagination` object, required
    - `current_page` number, required: Current page number (1-based)
    - `total_pages` number, required: Total number of pages
    - `total_count` number, required: Total number of items across all pages
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `limit` number, required: Items per page used for this response

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)