Careify

Supergood | Careify API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Careify API

Programmatically access Careify’s Electronic Visit Verification (EVV), authorizations, scheduling, and Medicaid reimbursement workflows with a stable REST API. In plain English: Careify is software that helps home and community-based service providers, clinics, and provider groups document care visits, verify time and location, track payer authorizations, and get paid. An unofficial API lets you create and verify EVV visits, sync patients and caregivers from your EHR, validate authorizations before scheduling, and automatically assemble claims from verified visits—all without manual portal work.

If you’re another tech company integrating with Careify, you gain clean read/write access to member and caregiver rosters, visit records, authorization data, and claim artifacts. That means you can pull EVV statuses, exception queues, and remittance summaries; push new patients and caregivers from your EHR; create visit check-in/out events; and build features like authorization-aware scheduling, real-time exception resolution, and automated reimbursement pipelines. Careify is also an alternative EVV option for Arkansas, so connecting EHR→EVV, billing→EVV, or other revenue cycle systems to Careify enables compliant EVV and Medicaid reimbursement flows in the state.

Supergood builds and operates production-grade, unofficial Careify integrations so your team can automate critical EVV and billing pipelines without heavy custom engineering.

Careify is used by home and community-based service providers, clinics, and provider groups to comply with EVV mandates, manage schedules and visits, document services, and support billing to Medicaid and Managed Care Organizations (MCOs). With an unofficial API, you can synchronize patient and caregiver rosters from your EHR, retrieve payer authorizations, create and verify EVV visits, assemble compliant claims, and reconcile payments end-to-end.

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

  • Pull: Patient/member profiles, caregiver rosters, payer authorizations, visit statuses, EVV exceptions, verified visit exports, claim statuses, remittance summaries
  • Push: New/updated members and caregivers from your EHR, scheduled visits with service codes, check-in/out events, visit edits with required 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 Careify?

Careify provides EVV and homecare management solutions used by providers to document and verify in-home and community-based services in alignment with the 21st Century Cures Act. Core workflows include mobile and telephony EVV, visit scheduling and documentation, exception handling, authorization tracking, and support for Medicaid/MCO reimbursement pipelines. Careify is available as an alternative EVV option in Arkansas, making it a relevant system for teams needing to connect EHR-to-EVV and billing-to-EVV for state compliance and payment.

Core product areas include:

  • EVV (mobile app, telephony, and aggregator connections)
  • Scheduling and visit management
  • Member/client and caregiver/provider rosters
  • Payer authorizations and service codes
  • Exception handling, audit trails, and compliance reporting
  • Export and billing support for Medicaid/MCO claims

Common data entities:

  • Members (patients/clients)
  • Caregivers/Providers (aides, nurses, staff)
  • Visits (EVV check-in/out, service codes, tasks, notes)
  • Authorizations (payer, service code, units, validity dates)
  • Payers/MCOs and service programs
  • Schedules and assignments
  • Exceptions (late/missing events, GPS mismatch, overlapping visits)
  • Claims (837P/I lines referencing verified visits)
  • Remittances (835 summaries for reconciliation)

The Careify Integration Challenge

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

  • State- and payer-specific rules: Arkansas and other Medicaid/MCO programs may require distinct service codes, modifiers, and EVV validation logic
  • Enterprise security: SSO/MFA and network controls complicate headless automation
  • Portal-first delivery: EVV, authorizations, and exception handling 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; data retention rules vary by jurisdiction

How Supergood Creates Careify 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 payers/programs
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports and SFTP/EDI flows with signed URL retrieval and delivery when applicable

Use Cases

EHR-to-EVV Synchronization

  • Push member and caregiver rosters from your EHR into Careify
  • 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, including Arkansas Medicaid requirements

EVV Exception Resolution

  • Pull exception queues (e.g., late arrival, missing check-out, GPS mismatch) and route issues 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 payer/state 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", "claims"]
  }
}

Members

GET /members: Retrieve member/client records to keep your EHR or scheduling system in sync. Filter by payer, program, status, and update window.

Query parameters

  • payerId: string (e.g., "payer_ar-medicaid")
  • program: string (e.g., "HCBS", "Personal Care")
  • status: string (e.g., "active", "inactive")
  • updatedSince: ISO 8601 timestamp
  • externalId: string

Example response

{
  "items": [
    {
      "memberId": "mem_9b42f0",
      "externalId": "ehr-12345",
      "firstName": "Jordan",
      "lastName": "Patel",
      "dateOfBirth": "1985-07-19",
      "payerId": "payer_ar-medicaid",
      "program": "HCBS",
      "eligibilityStatus": "eligible",
      "primaryAddress": {
        "line1": "100 Care Way",
        "city": "Little Rock",
        "region": "AR",
        "postalCode": "72201"
      },
      "contacts": [{"type": "phone", "value": "+1-501-555-0100"}],
      "updatedAt": "2026-01-19T13:55:02Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

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
  • providerId: string
  • serviceCode: string (HCPCS)
  • activeOn: ISO 8601 date
  • payerId: string

Example response

{
  "items": [
    {
      "authorizationId": "auth_7342c1",
      "authorizationNumber": "A-2025-11872",
      "memberId": "mem_9b42f0",
      "memberName": "Jordan Patel",
      "providerId": "prv_41cf92",
      "payerId": "payer_ar-medicaid",
      "program": "Personal Care",
      "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 Arkansas Alt EVV requirements.

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",
    "caregiverId": "cgv_2208aa",
    "authorizationId": "auth_7342c1",
    "payerId": "payer_ar-medicaid",
    "program": "Personal Care",
    "serviceCode": "T1019",
    "modifiers": ["U1"],
    "checkIn": {
      "timestamp": "2026-01-19T14:02:33Z",
      "method": "mobile",
      "location": {"lat": 34.7465, "lng": -92.2896},
      "deviceId": "ios-12a3"
    },
    "checkOut": {
      "timestamp": "2026-01-19T15:01:47Z",
      "method": "mobile",
      "location": {"lat": 34.7466, "lng": -92.2898}
    },
    "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"
}

Claims

POST /claims: Assemble an 837P/I claim from verified visits. Supergood normalizes service lines and can route the generated file to the configured submission channel (e.g., Arkansas Medicaid portal or clearinghouse).

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "claimType": "837P",
    "payerId": "payer_ar-medicaid",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Home Health",
      "name": "BrightCare Home Services",
      "billingAddress": {
        "line1": "100 Care Way",
        "city": "Little Rock",
        "region": "AR",
        "postalCode": "72201"
      }
    },
    "visits": [
      {"visitId": "vst_58d3e0", "units": 4, "serviceCode": "T1019", "modifiers": ["U1"]}
    ],
    "submissionChannel": "state_portal",
    "referenceId": "billing-batch-jan19"
  }'

Example response

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

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Careify products can this integration cover?

Supergood supports workflows across commonly used Careify 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, including Arkansas Alt EVV requirements.

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 Careify workflows?

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

Get Started →

Read more