Therap

Supergood | Therap API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Therap API

Programmatically access Electronic Visit Verification (EVV), service authorizations, visit documentation, and Medicaid reimbursement workflows in Therap with a stable REST API. Supergood builds and operates production-grade, unofficial Therap integrations so your team can automate EVV and billing pipelines without heavy custom engineering.

In plain English: Therap is software used by intellectual/developmental disability (I/DD) and home- and community-based services (HCBS) providers to document care, verify visits, manage authorizations, and bill Medicaid and Managed Care Organizations (MCOs). With an unofficial API, you could create and verify EVV visits, synchronize individual and staff rosters from your EHR, retrieve service authorizations, bundle verified visits into claims, and reconcile payments—end to end.

If you're a clinic, provider group, or a business focused on revenue cycle management, integrating your tech stack with Therap unlocks concrete data flows and features. A different tech company connecting to Therap might pull patient profiles, staff rosters, authorizations, visit evidence, and claim statuses; push scheduled visits, check-in/out events, compliant visit edits, and claim submissions; and build features like authorization-aware scheduling, exception resolution, and automated claim generation tied to EVV. This is particularly valuable for providers operating in states where Therap is widely used, including Alaska, North Dakota, and South Dakota.

  • Pull: Individual (client) profiles, staff rosters, service authorizations, visit statuses and verification details, exception queues, verified visit exports, claim statuses, remittance summaries
  • Push: New/updated individuals and staff from your EHR, scheduled visits, check-in/out events with GPS, visit edits with required reason codes, claim submissions referencing verified visits
  • Build: Authorization-aware scheduling, real-time EVV exception resolution, automatic assembly of 837P/I claims, reconciliation dashboards driven by EVV and remittance data

What is Therap?

Therap (https://www.therapservices.net/) provides an integrated documentation and billing platform for I/DD and HCBS providers, including EVV capture, electronic health and service records, ISP/goal tracking, incident management, scheduling, and Medicaid/MCO billing support. Therap’s modules span mobile EVV check-in/out, service authorization tracking, program/site management, health tracking, MAR, and export/EDI tooling for reimbursement.

Core product areas include:

  • Electronic Visit Verification (mobile app and telephony)
  • Individual (client) and staff rosters with program/site assignments
  • Service authorizations, service codes, units, and funding sources
  • Scheduling and visit documentation (tasks, signatures, GPS)
  • Exception handling, audit trails, and compliance reporting
  • Medicaid/MCO billing and 837/835 file support

Common data entities:

  • Individuals (clients/members)
  • Staff (caregivers/providers)
  • Programs/Sites and service settings
  • Service authorizations (funding source, service code, units, dates)
  • Visits (EVV check-in/out, tasks, verification artifacts)
  • Exceptions (missing events, location mismatch, overlapping visits)
  • Claims (837P/I with lines referencing verified visits)
  • Remittances (835 summaries for reconciliation)

The Therap Integration Challenge

Organizations rely on Therap daily, but turning portal-based EVV workflows into automated pipelines is hard:

  • State- and payer-specific nuances: Each Medicaid program/MCO may require distinct service codes, modifiers, units accounting, and validation logic (e.g., AK, ND, SD differences)
  • Strong enterprise security: SSO/MFA, role-based permissions, and network controls complicate headless automation
  • Portal-first delivery: Key EVV, authorization, and exception handling lives 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 demand compliant reason codes with audit trails; documentation retention and evidence artifacts vary by jurisdiction

How Supergood Creates Therap APIs

Supergood reverse-engineers authenticated browser flows, batch interfaces, and network interactions to deliver a resilient API endpoint layer.

  • Handles username/password, SSO/OAuth, 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 with signed URL retrieval and delivery where applicable

Use Cases

EHR-to-EVV Synchronization

  • Push individual and staff rosters from your EHR into Therap
  • Create visits automatically from your scheduling system with correct service codes and modifiers
  • Maintain a single source of truth for demographics, eligibility, and program/site assignments

Authorization-Aware Scheduling and Eligibility

  • Validate service authorizations before scheduling or visit creation
  • Track remaining authorized units and prevent over-utilization
  • Surface program- and state-specific rules for coordinators

EVV Exception Resolution

  • Pull exception queues and route issues (e.g., missing check-out, GPS mismatch, overlapping visits) 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

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": {
      "type": "totp",
      "code": "123456"
    }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_5a19f1",
    "name": "Therap Admin",
    "entitlements": ["evv", "authorizations", "billing", "individuals"]
  }
}

Service Authorizations

GET /service-authorizations: Retrieve service authorizations (funding source, service codes, units, date ranges) to validate scheduling and claim eligibility.

Query parameters

  • individualId: string
  • programId: string
  • serviceCode: string (HCPCS or state-specific)
  • activeOn: ISO 8601 date
  • fundingSourceId: string
  • state: string (e.g., "AK", "ND", "SD")

Example response

{
  "items": [
    {
      "authorizationId": "sa_8c3e91",
      "authorizationNumber": "AUTH-2026-11547",
      "individual": {"id": "ind_2fd04b", "name": "Avery Ross"},
      "program": {"id": "prog_residential_01", "name": "Residential Supports"},
      "fundingSource": {"id": "payer_nd-medicaid", "name": "ND Medicaid"},
      "serviceCode": "T1019",
      "modifiers": ["U1"],
      "unitsAuthorized": 120,
      "unitsUsed": 36,
      "unitsRemaining": 84,
      "rate": 23.50,
      "startDate": "2026-01-01",
      "endDate": "2026-03-31",
      "status": "active"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

EVV Visits

POST /evv/visits: Create or update an EVV visit record with check-in/out events, service details, and verification metadata. Supports compliant edit reason codes and state-specific validation.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/evv/visits \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "individualId": "ind_2fd04b",
    "staffId": "stf_74aa91",
    "serviceAuthorizationId": "sa_8c3e91",
    "programId": "prog_residential_01",
    "serviceCode": "T1019",
    "modifiers": ["U1"],
    "checkIn": {
      "timestamp": "2026-01-19T14:02:33Z",
      "method": "mobile",
      "location": {"lat": 47.9253, "lng": -97.0329},
      "deviceId": "ios-12a3"
    },
    "checkOut": {
      "timestamp": "2026-01-19T15:01:47Z",
      "method": "mobile",
      "location": {"lat": 47.9254, "lng": -97.0331}
    },
    "tasks": ["meal_prep", "community_integration"],
    "notes": "Client completed meal prep and a short walk.",
    "verification": {"gpsMatch": true, "signatureCapture": true},
    "signatures": [{"type": "client", "name": "Avery Ross"}],
    "editReasonCodes": [],
    "referenceId": "ehr-schedule-42391"
  }'

Example response

{
  "visitId": "vst_5e2a71",
  "status": "verified",
  "exceptions": [],
  "verifiedAt": "2026-01-19T15:02:02Z",
  "referenceId": "ehr-schedule-42391"
}

Claims

POST /billing/claims: Assemble an 837P/I claim from verified visits. Supergood normalizes service lines and can route the generated file to the configured submission channel.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/billing/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "claimType": "837P",
    "fundingSourceId": "payer_nd-medicaid",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Home And Community-Based Services",
      "name": "Prairie Care Services",
      "billingAddress": {
        "line1": "100 Care Way",
        "city": "Fargo",
        "region": "ND",
        "postalCode": "58102"
      }
    },
    "lines": [
      {"visitId": "vst_5e2a71", "units": 4, "serviceCode": "T1019", "modifiers": ["U1"], "rate": 23.50}
    ],
    "submissionChannel": "state_portal",
    "referenceId": "billing-batch-jan19"
  }'

Example response

{
  "claimId": "clm_91c0f4",
  "status": "queued",
  "edi": {"format": "837P", "size": 51234},
  "submissionChannel": "state_portal",
  "generatedAt": "2026-01-19T16:05:42Z",
  "reviewUrl": "https://download.therap.example/signed/abc123...",
  "referenceId": "billing-batch-jan19"
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; 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 Therap entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for exceptions, claim generation, and remittance updates

Performance Characteristics

  • 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

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your Therap product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Therap adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Therap evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Therap products can this integration cover?

Supergood supports workflows across commonly used Therap EVV and provider-facing modules, subject to your licensing and entitlements. We scope coverage (e.g., mobile/telephony EVV, authorizations, visit exports, claim assembly, remittance retrieval) during integration assessment.

Q: How are MFA, SSO, and batch interfaces handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For batch flows, we manage SFTP/EDI timing windows, generate 837 files, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate claims directly from verified visits?

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.

Ready to automate your Therap workflows?

Supergood can have your Therap integration live in days with no ongoing engineering maintenance.

Get Started →

Read more