API Endpoints
This page documents all available endpoints in the Telesoft Healthcare AI API. Each endpoint includes details on request parameters, response format, and example usage.
Contents
Diagnostics Endpoints
/v2/diagnostics/analyzeAnalyze patient data to generate diagnostic suggestions, confidence scores, and treatment recommendations.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
patientData | Object | Yes | Patient information including demographics, symptoms, vital signs, etc. |
patientData.age | Number | Yes | Patient's age in years |
patientData.sex | String | Yes | Patient's sex ('male', 'female', or 'other') |
patientData.symptoms | Array | Yes | Array of symptom strings |
patientData.vitalSigns | Object | No | Vital sign measurements |
patientData.medicalHistory | Array | No | Array of medical history conditions |
options | Object | No | Configuration options for the analysis |
options.includeConfidenceScores | Boolean | No | Include confidence scores in the response (default: true) |
options.maxResults | Number | No | Maximum number of diagnostic suggestions to return (default: 5) |
options.modelVersion | String | No | Version of the diagnostic model to use (default: latest) |
Response
{
"requestId": "req_7f9a2d7e8b3c",
"timestamp": "2025-05-06T12:34:56Z",
"data": {
"suggestions": [
{
"condition": "Migraine",
"icd10": "G43.909",
"description": "A neurological condition characterized by recurrent headaches."
},
{
"condition": "Upper Respiratory Infection",
"icd10": "J06.9",
"description": "An infection affecting the upper respiratory tract."
},
{
"condition": "Influenza",
"icd10": "J10.1",
"description": "A viral infection affecting the respiratory system."
}
],
"confidenceScores": [0.85, 0.67, 0.52],
"recommendations": {
"urgency": "medium",
"followUp": "primary care visit",
"diagnosticTests": ["CBC", "Metabolic panel"],
"treatments": ["Acetaminophen for fever", "Rest", "Hydration"]
}
},
"meta": {
"processingTimeMs": 143,
"version": "2.5.0",
"modelVersion": "general-v2.5"
}
}Example Request
import { TelesoftAI } from '@telesoft/healthcare-sdk';
const telesoft = new TelesoftAI({
apiKey: 'YOUR_API_KEY',
environment: 'production'
});
async function getDiagnosis() {
const result = await telesoft.diagnostics.analyze({
patientData: {
age: 35,
sex: 'female',
symptoms: ['headache', 'nausea', 'sensitivity to light'],
vitalSigns: {
temperature: 99.1,
bloodPressure: { systolic: 122, diastolic: 78 },
heartRate: 82
},
medicalHistory: ['migraine']
},
options: {
includeConfidenceScores: true,
includeDifferentialDiagnosis: true,
maxResults: 3
}
});
console.log(result);
}/v2/diagnostics/triagePerform initial triage of patient symptoms to determine urgency and care recommendations.
ℹ️ Common Use Case
This endpoint is commonly used in telemedicine applications to assess patient urgency before consultation.
/v2/diagnostics/follow-upGenerate personalized follow-up recommendations based on diagnostic results and patient profile.
Patient Management Endpoints
/v2/patientsCreate a new patient record in the Telesoft system.
⚠️ HIPAA Notice
This endpoint stores Protected Health Information (PHI) and requires a signed BAA for production usage.
/v2/patients/{patientId}Retrieve a patient's complete medical profile by their unique identifier.
/v2/patients/{patientId}Update an existing patient record with new information.
/v2/patients/{patientId}/recordsRetrieve a patient's medical records, including visit history, diagnoses, and treatments.
Medical Knowledge Endpoints
Access Telesoft's comprehensive medical knowledge base for information on conditions, treatments, medications, and guidelines.
/v2/knowledge/conditions/{icd10}Retrieve detailed information about a specific medical condition by ICD-10 code.
/v2/knowledge/medications/{rxnorm}Access comprehensive drug information by RxNorm code, including usage, dosing, and contraindications.
/v2/knowledge/treatments/{treatment_id}Get detailed information about specific treatment protocols and procedures.
/v2/knowledge/searchSearch across the medical knowledge base for conditions, treatments, and medications.
Healthcare Analytics Endpoints
These endpoints provide analytics capabilities for population health management and clinical insights.
/v2/analytics/populationAnalyze population health trends across specified demographics and conditions.
/v2/analytics/riskCalculate patient risk scores for specific conditions based on demographic and clinical factors.
/v2/analytics/outcomesAnalyze treatment outcomes and effectiveness across patient populations.
Medical Imaging Endpoints
AI-powered analysis of medical imaging data to assist with radiological diagnostics.
/v2/imaging/analyzeAnalyze medical images (X-ray, CT, MRI) to identify abnormalities and assist with diagnosis.
/v2/imaging/compareCompare multiple images of the same patient to identify changes over time.
System Endpoints
Utility endpoints for API status, account management, and system operations.
/v2/system/statusCheck the current operational status of the Telesoft API and services.
/v2/system/usageRetrieve API usage statistics and quotas for your account.
/v2/system/modelsList available AI models and their versions for various medical specialties.