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

# List transcriptions

`GET /transcriptions/list`

List transcription history with cursor pagination, newest first. Supports filtering by language or linked note.

## Query parameters

- `limit` integer
- `cursor` string
- `note_id` string, uuid
- `language` string
- `include` 'segments'

## Response `200`

Paginated transcription history.

- object
  - `data` Transcription[]
    - `id` string, uuid
    - `user_id` string
    - `text` string
    - `word_count` integer
    - `source` 'cloud' | 'local'
    - `provider` string
    - `model` string
    - `language` string
    - `audio_duration_ms` integer
    - `processing_ms` integer
    - `segments` TranscriptSegment[], nullable — Speaker-attributed segments with timestamps. Null for transcriptions without segment data.
      - `start` number, required — Start time in seconds.
      - `end` number, required — End time in seconds.
      - `text` string, required
      - `speaker` string — Speaker label (e.g. 'Speaker A').
      - `words` object[]
        - `word` string
        - `start` number
        - `end` number
        - `score` number — Confidence score 0.0-1.0.
    - `created_at` string, date-time
  - `has_more` boolean
  - `next_cursor` string, nullable

---

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