Valant API
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 for
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
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Valant product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Valant adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Valant evolves.
API Endpoints
Authentication
/sessionsEstablish 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.
Patients
/patientsRetrieve patient profiles with demographics, contacts, insurance policies, and portal status. Use this to synchronize rosters and eligibility context.
Appointments
/appointmentsCreate or update an appointment record with service and diagnosis details. Supports telehealth links and reminders.
Assessments
/assessments/resultsRetrieve completed measurement-based care instruments with scores and item-level responses.
Claims
/claimsAssemble an 837P claim from appointments/encounters. Supergood normalizes service lines and can route the generated file to the configured submission channel.
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
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
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
Frequently asked questions
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.
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.
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.