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/analyze
Analyze 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/triage
Perform 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-up
Generate personalized follow-up recommendations based on diagnostic results and patient profile.
Patient Management Endpoints
/v2/patients
Create 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}/records
Retrieve 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/search
Search 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/population
Analyze population health trends across specified demographics and conditions.
/v2/analytics/risk
Calculate patient risk scores for specific conditions based on demographic and clinical factors.
/v2/analytics/outcomes
Analyze treatment outcomes and effectiveness across patient populations.
Medical Imaging Endpoints
AI-powered analysis of medical imaging data to assist with radiological diagnostics.
/v2/imaging/analyze
Analyze medical images (X-ray, CT, MRI) to identify abnormalities and assist with diagnosis.
/v2/imaging/compare
Compare 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/status
Check the current operational status of the Telesoft API and services.
/v2/system/usage
Retrieve API usage statistics and quotas for your account.
/v2/system/models
List available AI models and their versions for various medical specialties.