HHAeXchange API
Programmatically access Electronic Visit Verification (EVV), authorizations, visit maintenance, and Medicaid reimbursement workflows in HHAeXchange with a stable REST API. Supergood builds and operates production-grade, unofficial HHAeXchange integrations so your team can automate EVV-to-billing pip
What is HHAeXchange?
HHAeXchange provides EVV and homecare management solutions used by provider agencies, clinics, and state Medicaid programs to ensure in-home and community-based services are delivered and documented as required by the 21st Century Cures Act. The platform spans caregiver mobile EVV, telephony, scheduling, visit documentation, authorization tracking, plan-of-care management, and billing/EDI connections to Medicaid and Managed Care Organizations (MCOs).
Many Medicaid programs and payer networks rely on HHAeXchange in whole or in part for EVV connectivity and billing workflows, with recent rollouts and expansions in states like Alabama, Illinois, Minnesota, New Jersey, Mississippi, and West Virginia.
Core product areas include:
- EVV (mobile app, telephony/IVR, aggregator connections)
- Scheduling and visit management
- Patient/client and caregiver/provider rosters
- Payer authorizations and service programs
- Plan of Care (tasks, required documentation)
- Exception handling, reason codes, and compliance reporting
- Export and billing support for Medicaid/MCO claims (EDI 837) and remittances (EDI 835)
Common data entities:
- Clients/Members (patients)
- Caregivers/Employees (aides, nurses, staff)
- Visits (EVV check-in/out, service codes, tasks)
- Authorizations (payer/program, units, date ranges)
- Plan of Care and visit tasks
- Exceptions (late/missing calls, GPS mismatch, overlapping visits)
- Schedules/Assignments
- Claims (837P/I referencing verified visits)
- Remittances (835 payment/denial summaries)
The HHAeXchange Integration Challenge
Organizations rely on HHAeXchange daily, but turning portal-based EVV workflows into automated pipelines is hard:
- State- and payer-specific rules: Each Medicaid/MCO program may use distinct service codes, modifiers, reason codes, and EVV validation logic
- Strong enterprise security: MFA, rotating cookies, and network controls complicate headless automation
- Portal-first delivery: Visit maintenance, exceptions, and reporting often live in web apps or batch exports, not unified public APIs
- File interfaces and timing windows: SFTP/EDI feeds, batching constraints, and daily submission windows must be respected
- Compliance nuances: Visit edits require compliant reason codes and audit trails; evidence artifacts (GPS, signatures) must be preserved
How Supergood Creates HHAeXchange APIs
Supergood reverse-engineers authenticated browser flows, batch interfaces, and network interactions to deliver a resilient API endpoint layer.
- Handles username/password and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes EVV, authorization, and claim objects so you can integrate once across states/MCOs
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges batch exports and SFTP/EDI flows where applicable with signed URL retrieval and delivery
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your HHAeXchange product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened HHAeXchange adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as HHAeXchange evolves.
Use Cases
EHR-to-EVV Synchronization
- Push patient and caregiver rosters from your EHR into HHAeXchange - Create visits automatically from your scheduling system with correct service codes and modifiers - Maintain a single source of truth for demographics and eligibility
Authorization-Aware Scheduling and Eligibility
- Validate authorizations before scheduling or visit creation - Track remaining authorized units and prevent over-utilization - Surface program-specific rules to care coordinators
EVV Exception Resolution
- Pull exception queues and route issues (e.g., late arrival, missing check-out, GPS mismatch) to staff for resolution - Apply compliant reason codes on visit edits with audit trails - Escalate unresolved exceptions prior to claim submission
Claims Generation and Reimbursement Automation
- Bundle verified visits into 837P/I claims with payer-specific formatting - Submit via the configured channel (state portal, MCO gateway, or clearinghouse) - Track claim statuses and reconcile remittances alongside EVV evidence
Audit and Compliance
- Export complete visit packets with timestamps, locations, signatures, and reason codes - Maintain machine-readable audit trails aligned to state/MCO requirements - Prove EVV coverage and claim provenance during reviews
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP); supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination
Rate limits
Tuned for enterprise throughput while honoring licensing and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of visits, authorizations, and claim artifacts
Security
Encrypted transport, scoped tokens, and audit logging; respects HHAeXchange entitlements and compliance requirements
Webhooks
Optional asynchronous delivery for exceptions, claim generation, and remittance updates
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume EVV and batch claims pipelines
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used HHAeXchange EVV portals and agency-facing tools, subject to your licensing and entitlements. We scope coverage (e.g., mobile/telephony EVV, authorizations, visit exports, claim assembly) during integration assessment.
We support username/password + MFA (SMS, email, TOTP). For batch flows, we manage SFTP/EDI timing windows, generate 837 files, and retrieve signed URLs or delivery confirmations programmatically.
Yes. You can assemble 837P/I from verified visits with payer-specific formatting. We can route submissions via your configured channel (state/MCO portals or clearinghouse) and return statuses and artifacts for reconciliation.