CareBridge

Supergood | CareBridge API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | CareBridge API

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

In plain English: CareBridge is software used by Medicaid home- and community-based service (HCBS) providers, caregiver agencies, and health plans to verify in‑home visits, manage authorizations, and support reimbursement. An unofficial API lets you sync rosters from your EHR, create and verify EVV visits, track exceptions, assemble claims from verified visits, and reconcile payments—without living in the portal.

If you’re another tech company—an EHR, workforce management app, billing platform, or RCM vendor—integrating with CareBridge means you can pull and push the data that matters: members, caregivers, authorizations, visit statuses, exceptions, verified visit exports, claims, and remittances. That unlocks features like authorization-aware scheduling, real-time exception resolution, automated claim building, and EVV-backed reimbursement tracking across states like Iowa, Tennessee, and Wyoming.

If you’re a clinic, provider group, or revenue cycle team, integrating your tech stack with CareBridge unlocks concrete data flows and features:

  • Pull: Member/client profiles, caregiver rosters, payer authorizations, schedules, visit statuses, exception queues, verified visit exports, claim statuses, remittance summaries
  • Push: New/updated members and caregivers from your EHR, scheduled visits, check-in/out events, visit edits with compliant reason codes, claim submissions referencing verified visits
  • Build: Authorization-aware scheduling, real-time EVV exception resolution, automatic claim assembly for 837P/I, reconciliation dashboards driven by EVV and remittance data

What is CareBridge?

CareBridge provides EVV and care management solutions widely used for Medicaid long-term services and supports (LTSS) and HCBS populations. Providers and fiscal intermediaries use CareBridge to ensure services are delivered and documented in compliance with the 21st Century Cures Act and payer requirements. The platform spans mobile EVV, scheduling and timesheets, visit verification and exceptions, authorization tracking, and connections to MCO/state reimbursement channels. In several programs across states including Tennessee, Iowa, and Wyoming, CareBridge is a core system for EVV capture and verification that feeds billing.

Core product areas include:

  • Electronic Visit Verification (mobile app and web portal)
  • Scheduling, timesheets, and visit management
  • Member/client and caregiver/provider rosters
  • Payer authorizations and service codes
  • Exception handling and compliance reporting
  • Export and billing support for Medicaid/MCO claims

Common data entities:

  • Members/Clients (patients)
  • Caregivers/Workers (aides, attendants, nurses)
  • Visits (EVV events, service codes, tasks, verification)
  • Authorizations (payer, service code, units, validity dates)
  • Schedules and assignments
  • Exceptions (missing events, GPS mismatch, overlapping visits, invalid authorization)
  • Timesheets (visit groupings and approvals)
  • Claims (837P/I lines referencing verified visits)
  • Remittances (835 summaries for reconciliation)

The CareBridge Integration Challenge

Organizations rely on CareBridge daily, but turning portal-centered workflows into automated pipelines is hard:

  • State- and payer-specific rules: IA, TN, and WY programs/MCOs enforce distinct EVV validation logic, service codes/modifiers, and submission timing
  • Strong enterprise security: SSO/MFA and IP controls complicate headless automation
  • Portal-first delivery: Key EVV, exceptions, and exports live in web apps or batch files, not a single public API
  • File interfaces and timing windows: SFTP/EDI feeds, batching constraints, and daily submission windows must be orchestrated
  • Compliance nuances: Visit edits require compliant reason codes and complete audit trails; retention rules vary by jurisdiction

How Supergood Creates CareBridge 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 where applicable with signed URL retrieval and delivery

Use Cases

EHR-to-EVV Synchronization

  • Push member and caregiver rosters from your EHR into CareBridge
  • Create visits automatically from your scheduling system with the correct service codes and modifiers
  • Maintain a single source of truth for demographics, eligibility, and authorizations

Authorization-Aware Scheduling and Eligibility

  • Validate authorizations before scheduling or visit creation
  • Track remaining authorized units and prevent over-utilization
  • Surface program-specific rules for IA, TN, and WY to care coordinators in real time

EVV Exception Resolution

  • Pull exception queues and route issues (e.g., missing clock-out, GPS mismatch, invalid authorization) 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_29b71a",
    "name": "EVV Admin",
    "entitlements": ["evv", "authorizations", "billing"]
  }
}

Authorizations

GET /authorizations: Retrieve payer/member service authorizations with allowed units, service codes, and date ranges. Use this to validate scheduling and claim eligibility.

Query parameters

  • memberId: string
  • workerId: string
  • serviceCode: string (HCPCS/HCPCS-like)
  • activeOn: ISO 8601 date
  • payerId: string
  • state: string (e.g., "TN", "IA", "WY")

Example response

{
  "items": [
    {
      "authorizationId": "auth_7342c1",
      "authorizationNumber": "A-2025-11872",
      "memberId": "mem_9b42f0",
      "memberName": "Jordan Patel",
      "payerId": "payer_tn-mco-1",
      "program": "HCBS",
      "state": "TN",
      "serviceCode": "T1019",
      "modifiers": ["U1"],
      "unitsAuthorized": 120,
      "unitsRemaining": 84,
      "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 validations.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/evv/visits \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "memberId": "mem_9b42f0",
    "workerId": "wrk_2208aa",
    "authorizationId": "auth_7342c1",
    "payerId": "payer_tn-mco-1",
    "state": "TN",
    "serviceCode": "T1019",
    "modifiers": ["U1"],
    "checkIn": {
      "timestamp": "2026-01-19T14:02:33Z",
      "method": "mobile",
      "location": {"lat": 36.1627, "lng": -86.7816},
      "deviceId": "ios-12a3"
    },
    "checkOut": {
      "timestamp": "2026-01-19T15:01:47Z",
      "method": "mobile",
      "location": {"lat": 36.1628, "lng": -86.7817}
    },
    "tasks": ["bathing", "meal_prep"],
    "notes": "Client requested meal prep and light housekeeping.",
    "verification": {"gpsMatch": true, "signatureCapture": true},
    "editReasonCodes": [],
    "referenceId": "ehr-schedule-42391"
  }'

Example response

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

Billing and 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 (CareBridge-connected MCO gateway, state portal, or your clearinghouse).

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",
    "state": "IA",
    "payerId": "payer_ia-medicaid",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Home Health",
      "name": "BrightCare Home Services",
      "billingAddress": {
        "line1": "100 Care Way",
        "city": "Des Moines",
        "region": "IA",
        "postalCode": "50309"
      }
    },
    "visits": [
      {"visitId": "vst_58d3e0", "units": 4, "serviceCode": "T1019", "modifiers": ["U1"]}
    ],
    "submissionChannel": "mco_gateway",
    "referenceId": "billing-batch-jan19"
  }'

Example response

{
  "claimId": "clm_71af2b",
  "status": "queued",
  "edi": {"format": "837P", "size": 51234},
  "submissionChannel": "mco_gateway",
  "createdAt": "2026-01-19T16:05:42Z",
  "reviewUrl": "https://download.carebridge.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 CareBridge 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 CareBridge product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which CareBridge products can this integration cover?

Supergood supports workflows across commonly used CareBridge EVV portals and agency-facing tools, subject to your licensing and entitlements. We scope coverage (e.g., mobile EVV, authorizations, visit exports, claim assembly) during integration assessment for IA, TN, and WY programs.

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.

Sandata API - Programmatically access Sandata EVV with Supergood

Ready to automate your CareBridge workflows?

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

Get Started →

Read more