Overview
Tiba Scribe API transforms unstructured clinical inputs—paper scans, images, and audio—into structured entities and EHR-ready data. It integrates with your EMR via secure REST endpoints and optional webhooks for async events.
Core Capabilities
- Document ingestion for PDF/JPG/PNG
- Audio transcription for clinical dictation
- Medical entity extraction (problems, meds, allergies, labs)
- EHR export (e.g., FHIR Bundle)
- AI-powered clinical search across a patient’s history
Architecture
A stateless API layer handles ingestion and retrieval; asynchronous processing normalizes and enriches data. Results are accessible via job endpoints and webhooks for real-time updates.
Data Flow
- POST document/audio to ingestion endpoints
- Receive a job_id for async processing
- Get notified via webhooks or poll job status
- Fetch entities and EHR export payloads
- Optionally query with natural language search
Endpoints
Key endpoints summary:
# 1) Document Ingestion
POST {API_BASE_URL}/api/v1/ingest
Content-Type: multipart/form-data
Authorization: Bearer <API_KEY>
file: (pdf|png|jpg)
patient_id: string
source: string (optional)
# 2) Audio Transcription
POST {API_BASE_URL}/api/v1/transcribe
Content-Type: multipart/form-data
Authorization: Bearer <API_KEY>
audio: (wav|mp3|m4a)
patient_id: string
# 3) Job Status & Results
GET {API_BASE_URL}/api/v1/jobs/{job_id}
Authorization: Bearer <API_KEY>
# 4) Clinical Search
POST {API_BASE_URL}/api/v1/search
Content-Type: application/json
Authorization: Bearer <API_KEY>
{ "patient_id": "12345", "query": "current meds and last HbA1c" }Webhooks
Subscribe to processing events:
- document.processed
- transcription.completed
- extraction.completed
POST https://your-app.com/webhooks/tiba
Headers:
- X-Tiba-Event: extraction.completed
- X-Tiba-Signature: t=timestamp,v1=hmac_sha256(payload, WEBHOOK_SECRET)
{ "job_id": "job_abc123", "patient_id": "12345", "status": "completed" }Security & Compliance
- HTTPS everywhere; Bearer auth
- Encryption in transit and at rest
- RBAC and least-privilege access
- Audit logs and immutable retention
- Compliance-aligned processes (HIPAA-friendly)
Pricing & Billing
Flexible pricing based on volume and features. Contact sales for a tailored plan.
Getting Access
- Register or sign in to your Tiba account
- Request API access from the Admin → API Keys page
- Configure webhooks and environment variables
FAQ
- Supported formats: PDF, JPG, PNG, WAV, MP3, M4A
- EHR exports: FHIR bundles (example), JSON payloads
- Async processing with job polling and webhooks
Contact
Questions or higher limits? Email devrel@tiba.health or contact our team.