Skip to main content
The Scribe API allows healthcare systems to integrate with the Telepatia platform. Use it to set consultation context, launch the scribe for a clinician, and retrieve session results after a consultation.

​
Integration flow

  1. Pick (or build) a Smart Template — Define which sections Telepatia generates using curated Telepatia nodes. Reuse across consultations.
  2. Set consultation context — Pre-populate patient data and attach the Smart Template (inline JSON or by medicalRecordConfigurationId).
  3. Generate a login link — Create a verification code to open the scribe, passing the consultationInternalId.
  4. Conduct the session — The clinician uses the scribe to record and finish the consultation.
  5. Retrieve session results — Look up the scribe session by consultationInternalId.
Smart Templates drive documentation. Build one with curated Telepatia nodes for clinical quality, or mix in Custom nodes for sections that aren’t covered. See Smart Templates.

​
Base URL

EnvironmentBase URL
Productionhttps://scribe-api.telepatia.ai

​
API versioning

All endpoints are prefixed with a version identifier (e.g. /v1/). The current stable version is v1. When breaking changes are introduced, a new version will be published and the previous version will remain available during a deprecation period. See the API Versioning guide for details.

​
Authentication

All endpoints require a Bearer token (API key) in the Authorization header. Contact your account manager to obtain your API key. See the Authentication guide for details.

​
Downloads

Import the API into any OpenAPI 3.1 tooling, load the ready-made Postman collection, or copy a per-endpoint prompt straight into your AI coding assistant.

Doctor API — OpenAPI

Download the Doctor API spec (JSON).

Doctor API — Postman

Import the Doctor API into Postman or Insomnia.

Institutional API — OpenAPI

Download the Institutional API spec (JSON).

Institutional API — Postman

Import the Institutional API into Postman or Insomnia.

AI Prompts

Copy-ready prompts per endpoint, drop-into-Cursor/Claude/Copilot to scaffold an integration.

​
Next steps

Smart Templates

Design how Telepatia generates each medical record — the recommended starting point.

Quickstart

Run through the full integration flow in under 5 minutes.

Telepatia Nodes

Curated prompt nodes maintained by Telepatia’s clinical team.

API Reference

Explore all available endpoints.