API Reference

import { TouchpointHQ } from '@touchpointhq/sdk';

// Initialize the client
const client = new TouchpointHQ({
  apiKey: process.env.TOUCHPOINTHQ_API_KEY,
  // Optional: specify environment
  environment: 'production', // or 'sandbox'
});

// Get HEDIS compliance rates
const compliance = await client.hedis.getCompliance({
  periodStart: '2024-01-01',
  periodEnd: '2024-12-31',
});

console.log(`Overall compliance: ${compliance.summary.above_50th} measures above 50th percentile`);

// List patients with pagination
const patients = await client.patients.list({
  status: 'active',
  limit: 50,
});

// Submit an assessment
const assessment = await client.assessments.create({
  patientId: 'pat_123abc',
  formCode: 'PHQ-9',
  responses: {
    q1: 2, q2: 1, q3: 2, q4: 3, q5: 2,
    q6: 1, q7: 2, q8: 1, q9: 0
  },
});

console.log(`Assessment score: ${assessment.totalScore} (${assessment.severityLevel})`);

import os
from touchpointhq import TouchpointHQ, AsyncTouchpointHQ

# Synchronous client
client = TouchpointHQ(api_key=os.environ["TOUCHPOINTHQ_API_KEY"])

# Get HEDIS compliance
compliance = client.hedis.get_compliance(
    period_start="2024-01-01",
    period_end="2024-12-31"
)

for measure in compliance.measures:
    print(f"{measure.measure_name}: {measure.rate}%")

# Async client for high-performance applications
async def main():
    async with AsyncTouchpointHQ(api_key=os.environ["TOUCHPOINTHQ_API_KEY"]) as client:
        # Fetch multiple resources concurrently
        compliance, patients, gaps = await asyncio.gather(
            client.hedis.get_compliance(),
            client.patients.list(status="active", limit=100),
            client.equity.get_gaps(measure_id="DSF-BH")
        )
        
        print(f"Found {len(patients.patients)} active patients")
        print(f"Equity gaps identified: {len(gaps.gaps)}")

# Run async code
import asyncio
asyncio.run(main())

{
  "id": "evt_abc123xyz",
  "type": "assessment.completed",
  "created_at": "2024-12-28T14:30:00Z",
  "data": {
    "assessment_id": "asmt_789def",
    "patient_id": "pat_456ghi",
    "patient_external_id": "MRN-12345",
    "form_code": "PHQ-9",
    "form_name": "Patient Health Questionnaire-9",
    "total_score": 14,
    "severity_level": "moderate",
    "previous_score": 18,
    "score_change": -4,
    "completed_at": "2024-12-28T14:29:45Z",
    "provider_id": "prov_123abc",
    "hedis_measures_affected": ["DSF-BH"],
    "alerts_generated": []
  },
  "metadata": {
    "organization_id": "org_xyz789",
    "environment": "production"
  }
}

{
  "id": "evt_def456uvw",
  "type": "alert.triggered",
  "created_at": "2024-12-28T14:31:00Z",
  "data": {
    "alert_id": "alert_xyz123",
    "alert_type": "score_increase",
    "severity": "high",
    "patient_id": "pat_456ghi",
    "patient_external_id": "MRN-12345",
    "form_code": "PHQ-9",
    "message": "PHQ-9 score increased significantly",
    "current_score": 22,
    "previous_score": 14,
    "score_change": 8,
    "percent_change": 57.1,
    "threshold_exceeded": true,
    "requires_follow_up": true,
    "provider_id": "prov_123abc",
    "assessment_id": "asmt_newxyz"
  },
  "metadata": {
    "organization_id": "org_xyz789",
    "environment": "production"
  }
}

{
  "id": "evt_ghi789rst",
  "type": "hedis.threshold_crossed",
  "created_at": "2024-12-28T15:00:00Z",
  "data": {
    "measure_id": "DSF-BH",
    "measure_name": "Depression Screening and Follow-Up",
    "previous_rate": 74.8,
    "current_rate": 75.2,
    "threshold_type": "50th_percentile",
    "threshold_value": 75.0,
    "direction": "crossed_above",
    "numerator": 752,
    "denominator": 1000
  },
  "metadata": {
    "organization_id": "org_xyz789",
    "environment": "production"
  }
}