---
title: "List partial transcriptions"
method: GET
path: "/workspaces/{workspaceId}/consultations/{consultationId}/partial-transcriptions"
tags: ["recordings", "transcriptions"]
---

# List partial transcriptions

`GET /workspaces/{workspaceId}/consultations/{consultationId}/partial-transcriptions`

## Request

- Base URL: `https://vetnio.com/api/v2`
- URL: `https://vetnio.com/api/v2/workspaces/{workspaceId}/consultations/{consultationId}/partial-transcriptions`
- Auth: HTTP bearer

Lists the partial transcriptions of a consultation: one per transcribed audio recording plus one per text snippet added with `POST .../partial-transcriptions`. They are not live or streaming results; an audio partial appears only after its recording has been transcribed. Only metadata is returned; the text of individual partials is not available through the API. Read the combined text with `GET .../transcription`. Useful to check which recordings have been transcribed and whether text snippets were added.

## Path parameters

- `workspaceId` string, required: Identifier of the clinic (workspace), as returned by `GET /workspaces`. The key's user must be a member of the clinic, or an admin of the organization it belongs to.
- `consultationId` string, required: Identifier of the consultation (UUID), as returned when it was created or by `GET /workspaces/{workspaceId}/consultations`. It must belong to the clinic in `workspaceId`.

## Response `200`

List of partial transcription metadata with count.

- PartialTranscriptionList: All partial transcriptions of a consultation. Each uploaded audio recording produces one partial transcription when it is transcribed, and each text snippet added through the API is another; together they form the full transcript.
  - `count` number, required: Number of partial transcriptions for this consultation.
  - `partialTranscriptions` object[], required: Partial transcriptions sorted by `recordingId`, which is chronological order and the order in which they are joined into the full transcript. Recordings shorter than one second appear here with empty text.
    - `recordingId` string, required: ID of the recording this partial transcription belongs to. Audio recordings use `<epoch-ms>-<language>` (the ID fixed when the upload URL was issued); text partials use `<epoch-ms>-<uuid>-text-<language>`. IDs sort chronologically.
    - `key` string, required: Internal storage key of the partial transcription. Informational only: it cannot be used to download the text through the API.
    - `isTextBased` boolean, required: `true` for text added with `POST .../partial-transcriptions`, `false` for the transcription of an uploaded audio recording. Derived from `-text-` in `recordingId`.

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/vetnio/apis/vetnio-api.md) - [All operations](https://skmtc.dev/vetnio/apis/vetnio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vetnio/apis/vetnio-api/revisions/d004afd5617d?raw)