Developers
GELYPTIC MD Public API
Bring ambient clinical documentation and global health intelligence into your EMR, telehealth platform or hospital system. Version 1 is live for approved integration partners.
Status
Every endpoint listed below is live and served today at /api/public/v1. Global health, surveillance and early-warning responses are aggregated and de-identified, with small groups suppressed, so they can never resolve to an individual.
Authentication
Bearer API keys, issued per application in the developer workspace. Keys are shown once, stored only as a hash and are never valid in browser code.
curl https://gelypticmd.com/api/public/v1/health
curl https://gelypticmd.com/api/public/v1/clinical/encounters?limit=25 \
-H "Authorization: Bearer $GELYPTIC_API_KEY"- Transport
- HTTPS only. Requests over plain HTTP are rejected, not redirected.
- Key scope
- Each key belongs to one application, one environment and a subset of that application's scopes.
- Rotation
- Rotating issues a replacement immediately and revokes the previous key, so you can roll credentials deliberately.
- Expiry
- Keys can be given an expiry date at creation; expired keys fail closed with 401.
- Storage
- Store keys as server-side secrets. A key exposed in browser or mobile code must be revoked immediately.
Scopes
Least privilege by default. A global health scope never unlocks individual patient records.
- clinical.read
- Read encounters and SOAP notes the application itself created.
- clinical.write
- Create and update encounters owned by the application.
- transcription.create
- Submit audio for transcription and SOAP drafting.
- transcription.stream
- Open live transcription sessions and send audio chunks while the visit runs.
- codes.read
- Search the ICD-10-CM reference list.
- global_health.read
- Read aggregated, de-identified global health indicators. Never clinical records.
- surveillance.read
- Read aggregated syndromic surveillance summaries.
- early_warning.read
- Read aggregated early-warning status and trends.
- academy.read
- Read the public Academy course catalogue.
- billing.read
- Read the calling organisation's own subscription state.
Endpoints
| Method | Path | Scope | Status |
|---|---|---|---|
| GET | /api/public/v1/health | public | live |
| GET | /api/public/v1/clinical/encounters | clinical.read | live |
| POST | /api/public/v1/clinical/encounters | clinical.write | live |
| GET | /api/public/v1/clinical/notes | clinical.read | live |
| GET | /api/public/v1/clinical/notes/{id} | clinical.read | live |
| GET | /api/public/v1/clinical/notes/{id}/fhir | clinical.read | live |
| GET | /api/public/v1/clinical/notes/{id}/hl7 | clinical.read | live |
| POST | /api/public/v1/transcription | transcription.create | live |
| POST | /api/public/v1/soap | transcription.create | live |
| GET | /api/public/v1/academy/courses | academy.read | live |
| GET | /api/public/v1/academy/courses/{slug} | academy.read | live |
| GET | /api/public/v1/global-health/signals | global_health.read | live |
| GET | /api/public/v1/global-health/surveillance | surveillance.read | live |
| GET | /api/public/v1/early-warning/signals | early_warning.read | live |
| GET | /api/public/v1/academy/certificates/{certificateId} | academy.read | live |
| GET | /api/public/v1/billing/subscription | billing.read | live |
| POST | /api/public/v1/stream/sessions | transcription.stream | live |
| POST | /api/public/v1/stream/sessions/{sessionId}/chunks | transcription.stream | live |
| GET | /api/public/v1/stream/sessions/{sessionId} | transcription.stream | live |
| POST | /api/public/v1/stream/sessions/{sessionId}/finalize | transcription.stream | live |
| GET | /api/public/v1/codes/icd10 | codes.read | live |
| GET | /api/public/v1/specialties | consultations:read | live |
A SOAP note is never returned in a finalized state until a clinician has reviewed and approved it in the application. The API surfaces AI output as a draft — it cannot be used to bypass clinician review.
API pricing
Simple, prepaid and predictable. You only pay for audio minutes processed.
50 free audio minutes to test integrations, read the docs and build prototypes. No card required.
Prepaid credit from $10, billed per audio minute processed. Processing pauses at a $0 balance, so there are never surprise bills.
Volume discounts, dedicated throughput, custom webhook configuration and premium support. Contact sales from the API Workspace.
Minutes are measured from the spoken words in each recording (about 150 words per minute, 15-second minimum). When credit runs out, billable endpoints return 402 PAYMENT_REQUIRED. Building for a client? Have their app send your affiliate ID in the X-Gelyptic-Affiliate header and earn 30% of their successful credit purchases for 12 months.
Rate limits
Every application carries its own requests-per-minute limit, visible in the developer workspace.
Rate-limited responses return a RATE_LIMITED error body plus a Retry-After header.
Uploads are capped at 60 MB per request and processed asynchronously.
Clients must honour Retry-After with exponential backoff and jitter.
SDKs
Published and generated from the live endpoint catalogue, so it cannot drift from what is served.
Typed server-side client for live v1 endpoints, structured errors, FHIR and HL7 exports, plus replay-safe webhook verification.
Server-side client with webhook verification and a restricted CSV helper for already-approved aggregate result rows.
Integrating GELYPTIC MD? Let's talk early.
Approved partners get production credentials, direct engineering contact and influence over the endpoint contract.