Transcript segments

GET /api/v1/meetings/{id}/transcript transcripts:read

The segments — speaker, time in milliseconds, text — of the most recent transcript that has not been deleted. ALL segments come back, always: no pagination. Transcripts are deleted after twelve months, and the endpoint then answers 404.

Path parameters

Name	Type	Required	Description
id	uuid	yes	The meeting, by the id from /meetings.

Response 200

The transcript.

Example response

{
  "meeting_id": "3b1f7c02-5d64-4c1a-9f88-2ac0e6b41d77",
  "transcript_id": "3b1f7c02-5d64-4c1a-9f88-2ac0e6b41d77",
  "language": "de",
  "segments": [
    {
      "idx": 0,
      "start_ms": 1200,
      "end_ms": 4300,
      "speaker": "Anna Weber",
      "text": "Then we send the quote by Friday.",
      "language": "de"
    }
  ]
}

Field	Type	Required	Description
meeting_id	uuid	yes	The meeting these rows belong to.
transcript_id	uuid	yes	Identifies the transcript these segments came from.
language	string | null	—	The language spoken in most of the transcript.
segments	object[]	yes	The segments, in the order they were spoken.
segments[].idx	integer	yes	Running number within the transcript.
segments[].start_ms	integer	yes	Start of the segment, in milliseconds from the beginning of the recording.
segments[].end_ms	integer	yes	End of the segment, on the same scale.
segments[].speaker	string | null	—	Speaker label, or the name assigned to it.
segments[].text	string	yes	What was said.
segments[].language	string | null	—	Language of this segment (ISO 639-1).

Other answers

Code	Meaning
401	No key, or a key that is not valid.
403	The key is missing the scope this endpoint needs.
404	Meeting not found or not visible to you — OR there is no transcript. The text in the error field tells the two cases apart.
500	The transcript could not be loaded.