API Documentation
SHOMA AI Health API gives you access to enterprise-grade healthcare AI capabilities. Process medical text, encode diagnoses, and integrate with your EHR system — all in one place.
Quickstart — First call in 5 minutes
Install the SDK
# Install via pip
pip install shoma-ai
Make your first API call
from shoma_ai import HealthAnalyzer
client = HealthAnalyzer(api_key="YOUR_API_KEY")
result = client.analyze(
text="Patient with chest pain and shortness of breath",
mode="clinical_nlp"
)
print(result.diagnoses, result.icd_codes)
Response (87ms)
{
"diagnoses": ["Acute coronary syndrome", "Dyspnea"],
"icd_codes": ["I24.9", "R06.00"],
"confidence": 0.94,
"fhir_bundle": {...}
}
API Reference
Base URL: https://api.shomahealth.ai
/v1/analyze/clinical-nlpCore/v1/analyze/lab-reportCore/v1/analyze/medicationCore/v1/icd/encodeCoding/v1/icd/decodeCoding/v1/patient/recordsRecords/v1/webhooksWebhooks/v1/webhooks/{id}WebhooksWebhooks
Register webhook endpoints to receive real-time notifications for async events. SHOMA AI sends signed HTTP POST requests to your endpoint.
Available Events
analysis.completedanalysis.failedcredit.depletedkey.expiringpayment.succeededpayment.failed# Register a webhook
response = client.webhooks.create(
url="https://your-app.com/webhooks/shoma",
events=["analysis.completed", "credit.depleted"]
)