API Documentation
Build custom integrations with the Scribeable REST API.
API Overview
The Scribeable API allows you to:
- Upload audio recordings programmatically
- Generate clinical notes from recordings
- Retrieve, list, and manage notes
- Access ICD-10 codes and billing data
- Manage templates and settings
- Integrate with custom workflows and third-party systems
API access is available on Team and Enterprise plans.
Authentication
All API requests require a Bearer token in the Authorization header:
# Include your API key in headers
Authorization: Bearer YOUR_API_KEY
Generate API keys in the web dashboard under Settings → API → Create Key. Keys are scoped to your organization and can be revoked at any time.
Key Endpoints
Core API endpoints:
Upload an audio file (WAV, M4A, WebM, MP3) for transcription. Returns a transcription ID for note generation.
Generate a clinical note from a transcription. Specify note type (22+ types) and specialty.
Retrieve a specific note by ID, including all sections, ICD-10 codes, and billing data.
List notes with filtering by date, patient, note type, and provider.
Retrieve billing analysis for a note: ICD-10 codes, HCC opportunities, E&M level, and CPT suggestions.
Note Type Parameter
When generating notes, pass the noteType parameter. Supported values:
# General
admissionHP, progressNote, dischargeSummary, clinicNote, referralNote, newPatientNote, followUpNote, handoff, casePresentation, deepConsult
# Specialty
consultation, psychiatricEvaluation, psychiatricProgressNote, strokeConsult
# Procedure
procedureNote, preOpNote, postOpNote, operativeNote, dentalEvaluation, dentalProcedure
# Emergency
edProviderNote, edTriageNote
# Specialty-specific
prenatalVisit, laborDeliveryNote, rehabilitationNote, criticalCareProgressNote
Rate Limits
API rate limits by plan:
- Team: 100 requests/minute, 10,000/day
- Enterprise: 1,000 requests/minute, unlimited daily
Rate limit headers are included in all responses:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1708300800
Webhooks
Webhook support for note lifecycle events is on our roadmap. Planned events include:
note.created— New note generatednote.updated— Note was editednote.exported— Note exported to EHRrecording.completed— Recording processed
Interested in webhooks? Contact our enterprise team to join the early access program.