CareLogic

Supergood | CareLogic by Qualifacts API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | CareLogic by Qualifacts API

Programmatically access client demographics, program enrollments, scheduling, clinical documentation, payer authorizations, and claims in CareLogic with a stable REST API. Supergood builds and operates production-grade, unofficial CareLogic integrations so your team can automate behavioral health EHR and revenue cycle workflows without heavy custom engineering.

CareLogic by Qualifacts is an EHR used by behavioral health and human services organizations to manage intake, treatment planning, progress notes, outcomes, scheduling, and reimbursement across Medicaid, commercial, and grant-funded programs. With an unofficial API, you could synchronize your client roster, manage episodes and program participation, create and complete appointments and notes, validate authorizations before service delivery, and assemble 837P claims with remittance tracking—end to end.

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

  • Pull: Client profiles, program enrollments, episodes, clinician rosters, appointment schedules, clinical notes, diagnoses, payer authorizations, claim statuses, remittance summaries
  • Push: New/updated clients from your CRM/intake, appointments from your scheduler, finalized clinical notes, treatment plan updates, claim submissions, referral and eligibility updates
  • Build: Authorization-aware scheduling, automated documentation workflows, outcomes reporting, reconciliation dashboards driven by encounters and remittance data

What is CareLogic?

CareLogic is a cloud-based behavioral health EHR from Qualifacts used by mental health, SUD, IDD, autism, and child & family service providers. It supports intake and referrals, clinical documentation, treatment planning, scheduling, authorizations, billing and claims, outcomes measurement, and compliance with HIPAA and 42 CFR Part 2. Learn more at https://www.qualifacts.com/about/carelogic-ehr/.

Core product areas include:

  • Client intake, referrals, demographics, and consents
  • Episodes of care and program enrollments
  • Scheduling and appointment management (individual, group, telehealth)
  • Clinical documentation (progress notes, treatment plans, diagnoses)
  • Authorization tracking, eligibility, and service utilization
  • Billing and reimbursement (837P claims, 835 remittance)
  • Outcomes measurement and reporting
  • Interoperability connectors (HL7/FHIR, payer/clearinghouse interfaces)

Common data entities:

  • Clients (patients/members)
  • Episodes and program enrollments
  • Clinicians and service staff
  • Appointments and encounters
  • Clinical notes and treatment plans
  • Diagnoses (ICD-10/DSM-5) and service codes (CPT/HCPCS)
  • Payers and insurance coverages
  • Authorizations (service code, units, date ranges)
  • Claims (837P service lines) and remittances (835)

The CareLogic Integration Challenge

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

  • Complex behavioral workflows: Episodes, multi-program participation, group services, and telehealth require nuanced scheduling and documentation logic
  • Strong enterprise security: SSO/MFA and 42 CFR Part 2 consent protections complicate headless automation
  • Portal-first delivery: Key documentation, authorization checks, and billing actions live in web apps or batch exports—not unified public APIs
  • File interfaces and timing windows: EDI/SFTP feeds, batching constraints, and clearinghouse submission windows must be respected
  • Compliance nuances: Note locking, signature capture, reason codes for edits, and audit trails are mandatory in behavioral health

How Supergood Creates CareLogic 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 client, appointment, note, authorization, and claim objects so you can integrate once across programs and payers
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports and EDI flows where applicable with signed URL retrieval and delivery

Use Cases

EHR-to-Roster Synchronization

  • Push client demographics from your intake/CRM into CareLogic
  • Maintain a single source of truth for episodes, program enrollments, and consents (HIPAA, 42 CFR Part 2)
  • Keep clinician rosters and service locations in sync

Authorization-Aware Scheduling and Eligibility

  • Validate member authorizations before creating appointments
  • Track remaining units and prevent over-utilization
  • Surface payer/program-specific rules to schedulers

Clinical Documentation Automation

  • Generate progress note shells from scheduled appointments with correct service codes and diagnoses
  • Capture signatures and lock notes programmatically with compliant audit trails
  • Link notes to treatment plan goals for outcomes reporting

Claims Generation and Reimbursement Automation

  • Assemble 837P claims from completed encounters with payer-specific formatting
  • Submit via configured channel (payer portal or clearinghouse)
  • Track claim statuses and reconcile 835 remittances alongside encounter data

Audit and Compliance

  • Export complete encounter packets with timestamps, authors, diagnoses, signatures, and edit reason codes
  • Maintain machine-readable audit trails aligned to HIPAA and 42 CFR Part 2
  • Prove documentation coverage and claim provenance during reviews

Available Endpoints

Authentication

POST /sessions: Establish a session using CareLogic 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_82df71",
    "name": "Behavioral Health Admin",
    "entitlements": ["clients", "appointments", "notes", "authorizations", "claims"]
  }
}

Clients

GET /clients: Retrieve client profiles with demographics, episodes/program enrollments, consents, and insurance coverages. Use this to synchronize your roster and eligibility context.

Query parameters

  • mrn: string
  • name: string (full or partial)
  • dob: ISO 8601 date
  • programId: string
  • activeOn: ISO 8601 date

Example response

{
  "items": [
    {
      "clientId": "cl_9b42f0",
      "mrn": "MRN-102938",
      "firstName": "Jordan",
      "lastName": "Patel",
      "dob": "1990-07-15",
      "gender": "nonbinary",
      "pronouns": "they/them",
      "address": {
        "line1": "100 Care Way",
        "city": "Columbus",
        "region": "OH",
        "postalCode": "43215"
      },
      "phones": [{"type": "mobile", "number": "+1-614-555-0199"}],
      "email": "[email protected]",
      "episodes": [
        {
          "episodeId": "ep_41cf92",
          "programId": "prog_outpatient",
          "programName": "Outpatient Mental Health",
          "startDate": "2025-12-01",
          "endDate": null,
          "status": "active"
        }
      ],
      "consents": {
        "hipaa": true,
        "part2": true,
        "consentDate": "2025-12-01"
      },
      "insuranceCoverages": [
        {
          "payerId": "payer_oh-medicaid",
          "planName": "Ohio Medicaid",
          "memberId": "MEM-774201",
          "active": true
        }
      ]
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Appointments

POST /appointments: Create or update an appointment with service details, clinician assignment, location/telehealth metadata, and optional authorization linkage.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/appointments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "cl_9b42f0",
    "clinicianId": "prv_2208aa",
    "serviceCode": "90834",
    "modifiers": ["GT"],
    "placeOfService": "02",
    "scheduledStart": "2026-01-19T14:00:00Z",
    "scheduledEnd": "2026-01-19T14:45:00Z",
    "location": {"siteId": "site_main", "telehealthUrl": "https://video.example/meet/abc"},
    "authorizationId": "auth_7342c1",
    "notes": "Weekly psychotherapy session.",
    "referenceId": "scheduler-42391"
  }'

Example response

{
  "appointmentId": "apt_58d3e0",
  "status": "scheduled",
  "createdAt": "2026-01-19T13:02:02Z",
  "referenceId": "scheduler-42391"
}

Clinical Notes

POST /clinical/notes: Create or update a clinical progress note associated with an appointment/encounter. Supports diagnoses, treatment plan linkage, signatures, and note locking with audit trails.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/clinical/notes \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "cl_9b42f0",
    "appointmentId": "apt_58d3e0",
    "clinicianId": "prv_2208aa",
    "encounterDate": "2026-01-19",
    "startTime": "14:00:00Z",
    "endTime": "14:45:00Z",
    "serviceCode": "90834",
    "diagnosisCodes": ["F32.9"],
    "treatmentPlanId": "tp_11a2c3",
    "goalsAddressed": ["Reduce depressive symptoms"],
    "interventions": ["CBT techniques", "Psychoeducation"],
    "riskAssessment": {"suicideRisk": "low"},
    "signatures": {"clinicianSigned": true, "clientSigned": false},
    "lockNote": true,
    "editReasonCodes": [],
    "referenceId": "note-20260119-apt58d3e0"
  }'

Example response

{
  "noteId": "note_71af2b",
  "status": "locked",
  "createdAt": "2026-01-19T15:02:42Z",
  "referenceId": "note-20260119-apt58d3e0"
}

Claims

POST /claims: Assemble an 837P claim from completed encounters/notes. 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>/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "claimType": "837P",
    "payerId": "payer_oh-medicaid",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Behavioral Health",
      "name": "BrightMind Behavioral Health",
      "billingAddress": {
        "line1": "200 Wellness Ave",
        "city": "Columbus",
        "region": "OH",
        "postalCode": "43215"
      }
    },
    "renderingProvider": {"npi": "0987654321", "name": "Alex Rivera, LISW"},
    "diagnosisCodes": ["F32.9"],
    "serviceLines": [
      {"appointmentId": "apt_58d3e0", "units": 1, "serviceCode": "90834", "modifiers": ["GT"], "placeOfService": "02"}
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "billing-batch-jan19"
  }'

Example response

{
  "claimId": "clm_92aa31",
  "status": "queued",
  "edi": {"format": "837P", "size": 41208},
  "submissionChannel": "clearinghouse",
  "createdAt": "2026-01-19T16:05:42Z",
  "reviewUrl": "https://download.carelogic.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 clients, appointments, notes, authorizations, and claim artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects CareLogic entitlements, HIPAA, and 42 CFR Part 2 consent constraints
  • Webhooks: Optional asynchronous delivery for appointment changes, note locking, authorization updates, and remittance statuses

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume scheduling, documentation, 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 CareLogic product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which CareLogic product areas can this integration cover?

Supergood supports workflows across commonly used CareLogic portals and agency-facing tools, subject to your licensing and entitlements. We scope coverage (e.g., client/episode management, scheduling, clinical notes, authorizations, claim assembly) 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 EDI/SFTP timing windows, generate 837 files, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate claims directly from completed encounters?

Yes. You can assemble 837P from documented encounters with payer-specific formatting. We can route submissions via your configured channel (payer portal or clearinghouse) and return statuses and artifacts for reconciliation.

Ready to automate your CareLogic workflows?

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

Get Started →

Read more