Skip to main content
A scribe session is created when a clinician conducts a consultation through the Telepatia interface. Once the session is finished, the structured medical record is available via the API.

Session lifecycle

StatusDescription
in_progressThe clinician is actively recording the session
completedThe session has ended and results are available
cancelledThe session was cancelled before completion

Retrieving a session

Use the consultationInternalId you provided (or received) when setting the consultation context:
curl https://synapse.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response:
{
  "id": "session-abc-123",
  "status": "completed",
  "createdAt": "2026-02-20T10:00:00Z",
  "completedAt": "2026-02-20T10:30:00Z",
  "patientName": "John Doe",
  "scribeSessionModality": "IN_PERSON",
  "consultationInternalId": "CONSULT-12345",
  "specialty": "Cardiology",
  "medicalRecordMutable": {
    "chiefComplaint": {
      "title": "Chief Complaint",
      "type": "text",
      "status": "completed",
      "content": "Patient reports headache"
    }
  }
}
If status is in_progress, the session is not yet finished. Poll this endpoint until status is completed before processing the results.

Medical record structure

The medicalRecordMutable object contains the structured output of the session. Each key is a section (e.g. chiefComplaint, physicalExam) with a title, type, and content field. The sections available depend on the session template used.