---
title: "List transcribes"
method: GET
path: "/service_agents/transcribes"
tags: ["Service Agent"]
---

# List transcribes

`GET /service_agents/transcribes`

Retrieves a paginated list of transcriptions for the service agent's customer. Optionally filter by the origin resource (reference_type + reference_id) to find all transcribes tied to a specific call, conference, or recording. Note a single reference can have multiple transcribes (e.g. one per language, or multiple start/stop sessions), so this always returns a list, not a single item.

## Query parameters

- `page_size` integer
- `page_token` string
- `reference_type` 'unknown' | 'recording' | 'call' | 'confbridge'
- `reference_id` string, uuid

## Response `200`

A list of transcriptions.

- 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).
- `500` — Internal error (INTERNAL).

---

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