Valant

Supergood | Valant API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Valant API

Valant is an electronic health record and practice management platform built specifically for behavioral health and mental health providers. With an unofficial API, you could programmatically manage patient records, appointments, outcomes measures, clinical documentation, insurance and billing workflows, and the patient portal—without being limited to portal screens or batch exports.

If you’re another tech company integrating with Valant—such as an EHR, CRM, telehealth app, analytics platform, or revenue cycle tool—you could pull patient demographics, provider schedules, assessment results, claims and remittances, and push new/updated patients, scheduled appointments, intake forms, and billing actions. This unlocks features like automated scheduling, measurement-based care dashboards, claim assembly, payment reconciliation, and seamless patient engagement.

Programmatically access behavioral health scheduling, outcomes measurement, clinical documentation artifacts, and reimbursement workflows in Valant with a stable REST API. Supergood builds and operates production-grade, unofficial Valant integrations so your team can automate critical care delivery and billing pipelines without heavy custom engineering.

Valant is used by behavioral health practices, clinics, and provider groups to manage appointments, documentation, measurement-based care (e.g., PHQ-9, GAD-7), ePrescribing, patient portal communications, and billing with payers and clearinghouses. With an unofficial API, you could synchronize patients and providers, create and update appointments (including telehealth links), retrieve and analyze outcomes measures, assemble 837 claims, and reconcile payments—end to end.

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

  • Pull: Patient profiles and insurance policies, provider rosters and locations, appointment schedules and statuses, completed assessments and scores (PHQ-9, GAD-7, etc.), encounter metadata, claim statuses, ERA/835 remittance summaries
  • Push: New/updated patients from your CRM/EHR, scheduled appointments and reschedules, intake forms and documents, telehealth invites, claim submissions referencing appointments/encounters
  • Build: Measurement-based care dashboards, appointment optimization and reminders, authorization- and eligibility-aware scheduling, automated 837 claim assembly, reconciliation workflows driven by ERA data

What is Valant?

Valant provides a behavioral health EHR and practice management solution designed for outpatient mental health clinics and group practices. Core product areas include scheduling, documentation, measurement-based care, ePrescribing (often via third-party services like DrFirst), patient portal engagement, billing and claims, and reporting.

Core product areas include:

  • Scheduling and appointment management (in-person, telehealth, group sessions)
  • Clinical documentation (intake notes, progress notes, treatment plans)
  • Outcomes measurement (PHQ-9, GAD-7, PCL-5, and other standardized instruments)
  • ePrescribing and medication management (commonly via integrated vendors like DrFirst)
  • Patient portal (forms, messages, consents, reminders)
  • Billing, claims (837P), and remittances (835/ERA)
  • Insurance policies, eligibility, and payer configurations
  • Telehealth session links and communications
  • Reporting and analytics

Common data entities:

  • Patients (demographics, contacts, portal enrollment)
  • Providers and locations
  • Appointments (type, status, CPT, diagnosis codes, telehealth)
  • Encounters and clinical notes
  • Diagnoses (ICD-10), treatment plans, and care goals
  • Assessments (instruments, responses, scores)
  • Insurance policies and payers
  • Claims and service lines (CPT, modifiers, POS, diagnosis pointers)
  • Remittances and payments
  • Documents (intake forms, consents, attachments)
  • Tasks and reminders

The Valant Integration Challenge

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

  • Limited public APIs: Many workflows live in web applications and reports; teams often resort to manual exports or ad hoc file transfers
  • Strong enterprise security: SSO and MFA (SMS, email, TOTP) make headless automation tricky without robust session management
  • Portal-first delivery: Scheduling, documentation, and assessment results are UI-centric, with inconsistent batch interfaces
  • File interfaces and timing windows: Clearinghouse and ERA/EDI processes may require SFTP and batching with strict submission windows
  • Data normalization: Outcomes measures vary by instrument/version; CPT, diagnosis pointers, and POS rules differ by payer
  • ePrescribing and telehealth are often vendor-mediated: Links and statuses can be siloed across tools
  • Compliance nuances: Behavioral health documentation and patient communications carry specific privacy and retention requirements

How Supergood Creates Valant 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 patient, appointment, assessment, and claim objects so you can integrate once
  • 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-Valant Synchronization

  • Push patient demographics and insurance data from your EHR or CRM into Valant
  • Create appointments automatically from your scheduling system with correct CPT codes and diagnosis pointers
  • Maintain a single source of truth for providers, locations, and eligibility

Insurance and Eligibility-Aware Scheduling

  • Validate insurance and payer setup before scheduling or claim creation
  • Surface payer-specific rules to schedulers and billing staff
  • Reduce denial risk with correct service codes, POS, and modifiers

Measurement-Based Care Automation

  • Pull completed assessment results (e.g., PHQ-9, GAD-7) from Valant and feed dashboards
  • Track baseline vs. current scores, severity categories, and changes over time
  • Trigger care plan updates and follow-ups based on thresholds

Claims Generation and Reimbursement Automation

  • Bundle appointments/encounters into 837P claims with payer-specific formatting
  • Submit via the configured channel (clearinghouse or payer portal)
  • Track claim statuses and reconcile remittances alongside clinical and scheduling data

Audit and Clinical Record Export

  • Export encounter summaries, notes, and assessment packets with timestamps and versions
  • Maintain machine-readable audit trails aligned to behavioral health documentation standards
  • Prove claim provenance with links to scheduled appointments and clinical events

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_19ab71",
    "name": "Behavioral Health Admin",
    "entitlements": ["patients", "appointments", "assessments", "claims"]
  }
}

Patients

GET /patients: Retrieve patient profiles with demographics, contacts, insurance policies, and portal status. Use this to synchronize rosters and eligibility context.

Query parameters

  • patientId: string
  • mrn: string
  • updatedAfter: ISO 8601 timestamp
  • activeOn: ISO 8601 date
  • providerId: string

Example response

{
  "items": [
    {
      "patientId": "pt_92c10f",
      "mrn": "MRN-10027",
      "firstName": "Avery",
      "lastName": "Nguyen",
      "dob": "1992-04-17",
      "sex": "female",
      "contact": {
        "email": "[email protected]",
        "phone": "+1-206-555-0192"
      },
      "address": {
        "line1": "422 Pine St",
        "city": "Seattle",
        "region": "WA",
        "postalCode": "98101"
      },
      "insurance": [
        {
          "type": "primary",
          "payerId": "payer_regence",
          "memberId": "RGN1234567",
          "groupNumber": "GRP-78291",
          "effectiveStart": "2025-01-01",
          "effectiveEnd": null
        }
      ],
      "primaryProviderId": "prv_41cf92",
      "portalEnrollment": {
        "status": "invited",
        "invitedOn": "2026-01-10T18:12:05Z"
      },
      "status": "active",
      "updatedAt": "2026-01-20T11:02:43Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Appointments

POST /appointments: Create or update an appointment record with service and diagnosis details. Supports telehealth links and reminders.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/appointments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "patientId": "pt_92c10f",
    "providerId": "prv_41cf92",
    "locationId": "loc_5a119b",
    "appointmentType": "Follow-up",
    "serviceCode": "90834",
    "diagnosisCodes": ["F41.1"],
    "startTime": "2026-01-25T15:00:00Z",
    "endTime": "2026-01-25T15:50:00Z",
    "placeOfService": "11",
    "telehealth": {"enabled": true},
    "reminders": {"email": true, "sms": true},
    "notes": "Telehealth follow-up for anxiety management.",
    "referenceId": "ehr-schedule-58320"
  }'

Example response

{
  "appointmentId": "apt_7c2e51",
  "status": "scheduled",
  "telehealth": {
    "enabled": true,
    "link": "https://valant.example/tele/apt_7c2e51"
  },
  "createdAt": "2026-01-20T12:14:19Z",
  "referenceId": "ehr-schedule-58320"
}

Assessments

GET /assessments/results: Retrieve completed measurement-based care instruments with scores and item-level responses.

Query parameters

  • patientId: string
  • instrument: string (e.g., PHQ-9, GAD-7, PCL-5)
  • completedAfter: ISO 8601 timestamp
  • providerId: string

Example response

{
  "items": [
    {
      "assessmentResultId": "asr_21aa90",
      "patientId": "pt_92c10f",
      "instrument": "PHQ-9",
      "version": "1.0",
      "scoreTotal": 12,
      "severity": "moderate",
      "answers": [
        {"questionId": "phq9_q1", "value": 2},
        {"questionId": "phq9_q2", "value": 1}
      ],
      "baselineScore": 16,
      "deltaFromBaseline": -4,
      "completedOn": "2026-01-18T16:31:22Z",
      "collectedVia": "patient_portal",
      "providerId": "prv_41cf92"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Claims

POST /claims: Assemble an 837P claim from appointments/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_regence",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Behavioral Health",
      "name": "Cascadia Behavioral Health",
      "billingAddress": {
        "line1": "200 Wellness Ave",
        "city": "Seattle",
        "region": "WA",
        "postalCode": "98109"
      }
    },
    "patient": {
      "patientId": "pt_92c10f",
      "memberId": "RGN1234567"
    },
    "serviceLines": [
      {
        "appointmentId": "apt_7c2e51",
        "serviceCode": "90834",
        "modifiers": ["95"],
        "diagnosisPointers": ["1"],
        "units": 1,
        "placeOfService": "02",
        "renderingProviderId": "prv_41cf92",
        "chargeAmount": 120.00
      }
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "billing-batch-jan25"
  }'

Example response

{
  "claimId": "clm_81af2b",
  "status": "queued",
  "edi": {"format": "837P", "size": 43120},
  "submissionChannel": "clearinghouse",
  "createdAt": "2026-01-20T13:05:42Z",
  "reviewUrl": "https://download.valant.example/signed/def456...",
  "referenceId": "billing-batch-jan25"
}

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 patients, appointments, assessments, and claim artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Valant entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for assessment completions, appointment changes, and remittance updates

Performance Characteristics

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

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Valant products can this integration cover?

Supergood supports workflows across commonly used Valant modules subject to your licensing and entitlements. We scope coverage (e.g., patients, appointments, assessments, documentation exports, 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 SFTP/EDI timing windows, generate 837 files, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate claims and reconcile ERAs from appointments/encounters?

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

Ready to automate your Valant workflows?

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

Get Started →

Read more