> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hihobbes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve transcripts safely

> Fetch ordered conversation turns only for sessions that need raw text.

Start from a filtered session list, then fetch transcripts only for selected
session UUIDs. This keeps PII exposure and quota use bounded.

<CodeGroup>
  ```bash cURL theme={null}
  SESSION_ID="018f3f6a-0d7b-7f56-bb2a-54c91e57a202"
  curl --fail-with-body \
    "https://api-us.hihobbes.com/api/v1/sessions/$SESSION_ID/transcript" \
    --header "Authorization: Bearer $HOBBES_API_KEY"
  ```

  ```python Python theme={null}
  import os
  import requests

  session_id = "018f3f6a-0d7b-7f56-bb2a-54c91e57a202"
  response = requests.get(
      f"https://api-us.hihobbes.com/api/v1/sessions/{session_id}/transcript",
      headers={"Authorization": f"Bearer {os.environ['HOBBES_API_KEY']}"},
      timeout=30,
  )
  if response.status_code == 429:
      raise RuntimeError(f"Retry after {response.headers['Retry-After']} seconds")
  response.raise_for_status()

  for turn in response.json()["entries"]:
      print(f"{turn['sequenceNumber']:>3} {turn['speaker']}: {turn['text']}")
  ```

  ```typescript TypeScript theme={null}
  const sessionId = "018f3f6a-0d7b-7f56-bb2a-54c91e57a202";
  const response = await fetch(
    `https://api-us.hihobbes.com/api/v1/sessions/${sessionId}/transcript`,
    { headers: { Authorization: `Bearer ${process.env.HOBBES_API_KEY}` } },
  );
  if (response.status === 429) {
    throw new Error(`Retry after ${response.headers.get("Retry-After")} seconds`);
  }
  if (!response.ok) throw new Error(await response.text());

  const transcript = await response.json();
  for (const turn of transcript.entries) {
    console.log(`${turn.sequenceNumber} ${turn.speaker}: ${turn.text}`);
  }
  ```
</CodeGroup>

<Warning>
  Transcript access requires `transcripts:read`, is limited to 2,000 successful
  reads per organization per UTC day, and can expose prospect PII.
</Warning>