Get session transcripts

Returns committed and final transcripts for a session, optionally filtered by revision kind. Committed segments are returned in sessionCommittedIndex order; final segments are returned in sequence order. Requires the torqee:transcripts:read scope.

GET/api/v1/sessions/{id}/transcripts

Authorization

AuthorizationOAuth2 access token · headerrequired

OAuth 2.1 authorization code flow with PKCE. Audience must be the connect URL.

Scopes:torqee:transcripts:read

AuthorizationBearer token · headerrequired

Workspace API key issued from the torqee web app. Pass the torqee_-prefixed key as the bearer token. API keys carry the same read scopes as OAuth tokens.

Path parameters

idstringrequired

Query parameters

revisionKindstring

Transcript revision: committed is realtime and final is generated after recording.

Allowed:committedfinal

Responses

200

Transcripts and their segments for the session

transcriptsobject[]required

Show properties

Array of object

idstringrequired

revisionKindstringrequired

Transcript revision: committed is realtime and final is generated after recording.

Allowed:committedfinal

createdAtstringrequired

segmentsobject[]required

Show properties

Array of object

idstringrequired

sequencenumberrequired

Order within an ingestion execution for committed revisions, or canonical order for final revisions.

sessionCommittedIndexnumber | nullrequired

Canonical session-wide order for committed revisions; null for final revisions.

timestampStartnumberrequired

timestampEndnumberrequired

speakerLabelstring | nullrequired

Human-readable speaker label for display. Its format is not guaranteed and may change; use speakerId to identify a speaker programmatically.

speakerIdstring | nullrequired

Speaker identifier assigned by the transcription provider, returned unmodified. Scoped to this transcript; the same value in another transcript may refer to a different speaker. For final revisions it matches the speaker identifier in the provider output (for ElevenLabs, words[].speaker_id). Null when the provider did not assign a speaker to the segment (for example, when diarization is off), and for committed revisions.

textstringrequired

confidencenumber | nullrequired

createdAtstringrequired

400

Invalid revision filter

errorstringrequired

Allowed:invalid_request

401

Missing or invalid credentials

errorstringrequired

Allowed:unauthorized

403

Membership revoked or insufficient scope

errorstringrequired

Allowed:insufficient_scopeforbidden

404

Session not found, or tenant database could not be resolved

errorstringrequired

Allowed:not_foundworkspace_not_found

500

Unexpected server error

errorstringrequired

Allowed:internal_server_error

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

revisionKindqueryTranscript revision: committed is realtime and final is generated after recording.idpath*

Request

curl -X GET 'https://connect.torqee.app/api/v1/sessions/string/transcripts' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://connect.torqee.app/api/v1/sessions/string/transcripts", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://connect.torqee.app/api/v1/sessions/string/transcripts",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "transcripts": [
    {
      "id": "string",
      "revisionKind": "committed",
      "createdAt": "string",
      "segments": [
        {
          "id": "string",
          "sequence": 0,
          "sessionCommittedIndex": 0,
          "timestampStart": 0,
          "timestampEnd": 0,
          "speakerLabel": "string",
          "speakerId": "string",
          "text": "string",
          "confidence": 0,
          "createdAt": "string"
        }
      ]
    }
  ]
}

{
  "error": "invalid_request"
}

{
  "error": "unauthorized"
}

{
  "error": "insufficient_scope"
}

{
  "error": "not_found"
}

{
  "error": "internal_server_error"
}