---
title: "List transcribes for a recording"
method: GET
path: "/recordings/{id}/transcribes"
tags: ["Recording"]
---

# List transcribes for a recording

`GET /recordings/{id}/transcribes`

Retrieves the transcribes tied to a specific recording, regardless of the transcribe owner. This includes transcribes produced internally when an AI summary was generated for the recording, which are not visible through the top-level `GET /transcribes` list (that list is scoped to the caller's own customer). Access is gated by ownership of the recording itself: the caller must be an admin/manager of the recording's owning customer. A single recording can have multiple transcribes (e.g. one per language), so this always returns a list.

## Path parameters

- `id` string, required

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of transcribes tied to the recording.

- object
  - `next_page_token` string — Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` TranscribeManagerTranscribe[]
    - `id` string, uuid — The unique identifier of the transcribe session. Returned from the `POST /transcribes` or `GET /transcribes` response.
    - `customer_id` string, uuid — The unique identifier of the customer who owns this transcribe session. Returned from the `GET /customers` response.
    - `activeflow_id` string, uuid — The unique identifier of the activeflow associated with this transcribe session. Returned from the `POST /activeflows` or `GET /activeflows` response.
    - `on_end_flow_id` string, uuid — The unique identifier of the flow to execute when the transcribe session ends. Returned from the `POST /flows` or `GET /flows` response.
    - `reference_type` 'unknown' | 'recording' | 'call' | 'confbridge'
    - `reference_id` string, uuid — The unique identifier of the resource being transcribed (call, conference, or recording). Returned from the corresponding resource endpoint.
    - `status` 'progressing' | 'done'
    - `language` string — BCP47 type's language code.
    - `direction` 'both' | 'in' | 'out'
    - `provider` '' | 'gcp' | 'aws'
    - `tm_create` string, date-time — Timestamp when created
    - `tm_update` string, date-time — Timestamp when updated
    - `tm_delete` string, date-time — Timestamp when deleted

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `404` — Resource not found (NOT_FOUND).
- `500` — Internal error (INTERNAL).
- `503` — Upstream unavailable (UNAVAILABLE).

## Changes

- **2026-09-14** `fdcd6f4b11d4` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/recordings/:id/transcribes/get.md)

---

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