HomeDocumentation

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.

Diagnostics Endpoints

POST/v2/diagnostics/analyze

Analyze patient data to generate diagnostic suggestions, confidence scores, and treatment recommendations.

Request Parameters

ParameterTypeRequiredDescription
patientDataObjectYesPatient information including demographics, symptoms, vital signs, etc.
patientData.ageNumberYesPatient's age in years
patientData.sexStringYesPatient's sex ('male', 'female', or 'other')
patientData.symptomsArrayYesArray of symptom strings
patientData.vitalSignsObjectNoVital sign measurements
patientData.medicalHistoryArrayNoArray of medical history conditions
optionsObjectNoConfiguration options for the analysis
options.includeConfidenceScoresBooleanNoInclude confidence scores in the response (default: true)
options.maxResultsNumberNoMaximum number of diagnostic suggestions to return (default: 5)
options.modelVersionStringNoVersion 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);
}
POST/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.

POST/v2/diagnostics/follow-up

Generate personalized follow-up recommendations based on diagnostic results and patient profile.

Patient Management Endpoints

POST/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.

GET/v2/patients/{patientId}

Retrieve a patient's complete medical profile by their unique identifier.

PUT/v2/patients/{patientId}

Update an existing patient record with new information.

GET/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.

GET/v2/knowledge/conditions/{icd10}

Retrieve detailed information about a specific medical condition by ICD-10 code.

GET/v2/knowledge/medications/{rxnorm}

Access comprehensive drug information by RxNorm code, including usage, dosing, and contraindications.

GET/v2/knowledge/treatments/{treatment_id}

Get detailed information about specific treatment protocols and procedures.

POST/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.

POST/v2/analytics/population

Analyze population health trends across specified demographics and conditions.

POST/v2/analytics/risk

Calculate patient risk scores for specific conditions based on demographic and clinical factors.

POST/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.

POST/v2/imaging/analyze

Analyze medical images (X-ray, CT, MRI) to identify abnormalities and assist with diagnosis.

POST/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.

GET/v2/system/status

Check the current operational status of the Telesoft API and services.

GET/v2/system/usage

Retrieve API usage statistics and quotas for your account.

GET/v2/system/models

List available AI models and their versions for various medical specialties.