Fetch transcript and audio

When to use this

Use GET /external/v1/encounters/{encounter_id}/documents/{document_id}/transcript for finalized transcript turns from an ambient transcript document.

Use GET /external/v1/encounters/{encounter_id}/documents/{document_id}/audio to request a short-lived URL for recording-backed audio when audio is available for that ambient transcript document.

Required scopes

Transcript access is document-scoped. Audio URL access requires document route access plus the additional recordings:read scope.

Request

Fetch finalized transcript turns:

curl "https://api.example.test/external/v1/encounters/enc_9YpJvK2/documents/doc_Ambient1/transcript" \
  -H "Authorization: Bearer ch_sk_example_123"

Request a short-lived audio URL:

curl "https://api.example.test/external/v1/encounters/enc_9YpJvK2/documents/doc_Ambient1/audio" \
  -H "Authorization: Bearer ch_sk_example_123"

Neither route accepts query parameters.

Response

Transcript response:

{
  "encounter_id": "enc_9YpJvK2",
  "document_id": "doc_Ambient1",
  "transcript": {
    "provider": "deepgram",
    "audio_duration_seconds": 842.4,
    "turns": [
      {
        "speaker": "clinician",
        "start": 0.0,
        "end": 1.6,
        "text": "Good morning."
      },
      {
        "speaker": "patient",
        "start": 1.8,
        "end": 3.1,
        "text": "Good morning."
      }
    ]
  }
}

Audio URL response:

{
  "audio_url": "https://media.charthero.example/signed-recording.wav?token=example",
  "expires_at": "2026-05-25T15:15:00Z"
}

Audio URLs are temporary access artifacts. Do not store signed URLs as durable identifiers, put them in client-visible logs, or use them after expiration.

Common errors

Next step

Use Receive webhooks when you want ChartHero to notify your receiver before you fetch transcript resources. See the transcript and audio endpoints in the API Reference for the generated endpoint contracts.