Sign in

v2

latestOpenAPI 3.1.02026-07-2664759910.6 KB
external
external-v2

Read Audio Recording

Fetch the current public transcript and metadata for a single audio recording by ID.

get/v2/audio-recordings/{audio_recording_id}

Path parameters

audio_recording_idstring uuid required

UUID of the audio recording to read. The caller must be able to access this recording.

UUID of the audio recording to read. The caller must be able to access this recording.

Query parameters

transcript_speaker_labelsboolean

When true (default), transcript turns are prefixed with available speaker labels. Labels may be participant names, generic diarization labels such as [Speaker 1], or app channel labels such as [Speaker] and [Other Speakers]. Participant names are included only when available; many transcripts use generic diarization labels or app channel labels instead. Generic labels are speaker grouping context, not verified participant identity. When false, the same transcript content is returned without speaker labels.

When true (default), transcript turns are prefixed with available speaker labels. Labels may be participant names, generic diarization labels such as [Speaker 1], or app channel labels such as [Speaker] and [Other Speakers]. Participant names are included only when available; many transcripts use generic diarization labels or app channel labels instead. Generic labels are speaker grouping context, not verified participant identity. When false, the same transcript content is returned without speaker labels.

Response

OK

associated_note_idstring uuid nullable

UUID of the note directly associated with this audio recording, if any.

created_atstring date-time required

Creation timestamp for the audio recording in ISO 8601 format.

duration_secondsinteger nullable

Audio duration in seconds when available.

idstring uuid required

UUID of the requested audio recording.

request_idstring required

Identifier for this API request. Useful for tracing and support.

transcriptstring nullable

Transcript text for the audio recording when available. By default, transcript turns are returned with available speaker labels, including participant names, generic diarization labels such as [Speaker 1], and app channel labels such as [Speaker] and [Other Speakers]. Participant names are included only when available; many transcripts use generic diarization labels or app channel labels instead. Generic labels are speaker grouping context, not verified participant identity. When transcript_speaker_labels=false is requested, speaker labels are omitted. Null means the recording exists but transcript data is not available yet.

updated_atstring date-time required

Last modification timestamp for the audio recording in ISO 8601 format.

Example response

{
  "associated_note_id": "5e29c8a2-c73b-476b-9311-e2579712d4b1",
  "created_at": "2025-04-11T04:47:14.457Z",
  "duration_seconds": 123,
  "id": "78ff64bc-09e3-4fd7-a4b9-53c258f35619",
  "request_id": "api-request-036ed6c7-de00-459f-a89b-43d26aafe522",
  "transcript": "[Speaker 1] Thanks for joining the call.\n\n[Speaker 2] Happy to be here.\n\n[Speaker 1] Let's review the launch plan.",
  "updated_at": "2025-04-11T04:47:19.702Z"
}