Credible

Supergood | Credible API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Credible API

Programmatically access client rosters, scheduling, clinical documentation, payer authorizations, and behavioral health billing workflows in Credible with a stable REST API. Supergood builds and operates production-grade, unofficial Credible integrations so your team can automate intake, service delivery, and revenue cycle pipelines without heavy custom engineering.

Credible is an electronic health record (EHR) platform used by behavioral health and human services organizations to manage clients, treatment plans, appointments, clinical notes, payer authorizations, and claims. With an unofficial API, you could synchronize client and staff rosters, create and document encounters, validate authorizations before service, assemble and submit claims, and reconcile payments—end to end.

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

  • Pull: Client demographics, program enrollments, staff rosters, schedules and attendance, diagnoses, treatment plans, authorizations, encounter history, claim statuses, remittance summaries
  • Push: New/updated clients and staff, scheduled appointments or group sessions, service documentation (encounters, progress notes), authorization-aware edits, claim submissions referencing documented encounters
  • Build: Intake automation, authorization-aware scheduling, outcomes dashboards, automatic 837P/I claim assembly, and reconciliation workflows driven by encounter and remittance data

What is Credible?

Credible (from Qualifacts) is a comprehensive EHR designed for behavioral health and human services organizations, including community mental health centers, SUD treatment providers, IDD services, and residential programs. The platform spans clinical documentation, treatment planning, scheduling, client portal and telehealth, ePrescribing, labs/HIE connectivity, authorizations, and full revenue cycle management (837/835).

Core product areas include:

  • Client intake and demographics, program enrollments, and eligibility
  • Scheduling and attendance (individual and group)
  • Clinical documentation (progress notes, assessments, treatment plans)
  • Diagnoses, medications/ePrescribing, and care coordination
  • Payer authorizations and service codes specific to behavioral health (e.g., H2019, H0032, 90834)
  • Billing and claims (837P/I) with remittance reconciliation (835)
  • Reporting and outcomes measurement across programs

Common data entities:

  • Clients (patients) and caregivers/support contacts
  • Staff (clinicians, case managers, billers)
  • Programs, locations, and service lines
  • Appointments and group sessions (attendance, status)
  • Encounters/Services (documented care with billing details)
  • Authorizations (payer, units, service codes, date ranges)
  • Diagnoses and problem lists
  • Claims (837P/I) and remittances (835)

The Credible Integration Challenge

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

  • Program- and payer-specific rules: Behavioral health services vary by program (MH, SUD, IDD) and payer, affecting service codes, modifiers, units, and documentation requirements
  • Strong enterprise security: SSO/MFA and network controls complicate headless automation across staff roles and environments
  • Portal-first and reporting-heavy delivery: Key scheduling, documentation, and billing actions live in web apps and report exports, not unified public APIs
  • Batch interfaces and timing windows: SFTP/EDI feeds, batching constraints, and daily submission windows must be respected for claims and remits
  • Custom forms and data variability: Agency-specific forms and workflows create schema differences that need normalization for downstream automation

How Supergood Creates Credible APIs

Supergood reverse-engineers authenticated browser flows, report exports, and batch interfaces 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, authorization, encounter, and claim objects so you can integrate once across programs/payers
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges report exports and SFTP/EDI flows with signed URL retrieval and delivery

Use Cases

Roster and Scheduling Synchronization

  • Push client and staff rosters from your CRM or HRIS into Credible
  • Create appointments automatically from your scheduling system with correct service codes and program/authorization references
  • Maintain a single source of truth for demographics, eligibility, and attendance

Authorization-Aware Service Delivery

  • Validate authorizations before scheduling or encounter creation
  • Track remaining units and prevent over-utilization
  • Surface payer and program-specific rules to care coordinators

Clinical Documentation and Outcomes

  • Pull treatment plans, diagnoses, and prior encounters to prefill documentation
  • Post progress notes and finalize encounters with audit trails and signatures
  • Aggregate outcomes across programs for analytics and quality improvement

Claims Generation and Reimbursement Automation

  • Bundle documented encounters into 837P/I claims with payer-specific formatting
  • Submit via the configured channel (clearinghouse or payer portal)
  • Track claim statuses and reconcile remittances alongside encounter evidence

Audit and Compliance

  • Export complete encounter packets with timestamps, providers, place of service, signatures, and reason codes
  • Maintain machine-readable audit trails aligned to behavioral health and payer requirements
  • Prove authorization checks 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_1ac72f",
    "name": "EHR Admin",
    "entitlements": ["clients", "authorizations", "encounters", "claims"]
  }
}

Clients

GET /clients: Retrieve client demographics, program enrollments, diagnoses, and payer relationships. Use this to synchronize rosters and eligibility.

Query parameters

  • mrn: string
  • lastName: string
  • dateOfBirth: ISO 8601 date
  • programId: string
  • activeOn: ISO 8601 date
  • payerId: string

Example response

{
  "items": [
    {
      "clientId": "cl_92a10e",
      "mrn": "MRN-001234",
      "firstName": "Amina",
      "lastName": "Diaz",
      "dateOfBirth": "1990-06-18",
      "gender": "female",
      "contact": {
        "phone": "+1-555-0112",
        "email": "[email protected]",
        "address": {
          "line1": "120 Wellness Ave",
          "city": "Nashville",
          "region": "TN",
          "postalCode": "37203"
        }
      },
      "identifiers": {
        "medicaidId": "TN-77829123",
        "ssnLast4": "1123"
      },
      "programs": [
        {"programId": "prg_mh_outpatient", "startDate": "2025-09-01", "endDate": null}
      ],
      "payers": [
        {"payerId": "payer_tn-medicaid", "planName": "TennCare", "memberId": "M-5512981", "eligibilityStatus": "active"}
      ],
      "diagnoses": [
        {"code": "F33.1", "description": "Major depressive disorder, recurrent, moderate", "startDate": "2025-09-03"}
      ],
      "primaryLocationId": "loc_main"
    }
  ],
  "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 encounter eligibility.

Query parameters

  • clientId: string
  • payerId: string
  • programId: string
  • serviceCode: string (CPT/HCPCS-like, e.g., H2019, 90834)
  • activeOn: ISO 8601 date

Example response

{
  "items": [
    {
      "authorizationId": "auth_7342c1",
      "authorizationNumber": "A-2026-11872",
      "clientId": "cl_92a10e",
      "clientName": "Amina Diaz",
      "payerId": "payer_tn-medicaid",
      "program": "Mental Health Outpatient",
      "serviceCode": "90834",
      "modifiers": ["GT"],
      "unitsAuthorized": 24,
      "unitsRemaining": 20,
      "startDate": "2026-01-01",
      "endDate": "2026-03-31",
      "status": "active"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Encounters

POST /encounters: Create or update a documented service encounter with scheduling context, billing details, and verification metadata. Supports compliant edit reason codes and signatures.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/encounters \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "cl_92a10e",
    "staffId": "stf_2208aa",
    "programId": "prg_mh_outpatient",
    "locationId": "loc_main",
    "authorizationId": "auth_7342c1",
    "serviceCode": "90834",
    "modifiers": ["GT"],
    "placeOfService": "11",
    "startTime": "2026-01-19T14:02:33Z",
    "endTime": "2026-01-19T14:47:33Z",
    "units": 1,
    "diagnosisCodes": ["F33.1"],
    "telehealth": true,
    "noteText": "Individual psychotherapy focused on coping strategies and safety planning.",
    "signatures": {
      "staffSignedAt": "2026-01-19T15:00:11Z",
      "clientSignedAt": "2026-01-19T15:02:47Z"
    },
    "editReasonCodes": [],
    "referenceId": "ehr-appointment-42391",
    "finalized": true
  }'

Example response

{
  "encounterId": "enc_58d3e0",
  "status": "ready_to_bill",
  "exceptions": [],
  "createdAt": "2026-01-19T15:02:02Z",
  "referenceId": "ehr-appointment-42391"
}

Claims

POST /claims: Assemble an 837P/I claim from documented encounters. 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_tn-medicaid",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Behavioral Health",
      "name": "Riverbend Behavioral Health",
      "billingAddress": {
        "line1": "100 Care Way",
        "city": "Nashville",
        "region": "TN",
        "postalCode": "37215"
      }
    },
    "encounters": [
      {"encounterId": "enc_58d3e0", "units": 1, "serviceCode": "90834", "modifiers": ["GT"], "diagnosisPointer": 1}
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "billing-batch-jan19"
  }'

Example response

{
  "claimId": "clm_71af2b",
  "status": "queued",
  "edi": {"format": "837P", "size": 44218},
  "submissionChannel": "clearinghouse",
  "createdAt": "2026-01-19T16:05:42Z",
  "reviewUrl": "https://download.credible.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, authorizations, encounters, and claim artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Credible entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for schedule updates, encounter finalizations, claim generation, and remittance updates

Performance Characteristics

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

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Credible modules can this integration cover?

Supergood supports workflows across commonly used Credible modules and agency-facing tools, subject to your licensing and entitlements. We scope coverage (e.g., clients, scheduling, authorizations, encounters, claim assembly) during integration assessment.

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

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

Q: Can I generate claims directly from documented encounters?

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

Q: What about custom forms, treatment plans, and group sessions?

We map custom forms and treatment plan fields into normalized objects, track attendance for group sessions, and preserve audit trails, signatures, and compliant reason codes during encounter edits.

Ready to automate your Credible workflows?

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

Get Started →

Read more