Kipu Health API
If you’re a technology company integrating with a Kipu-powered provider, an unofficial API unlocks reliable push/pull access to patients, episodes, authorizations, scheduling artifacts, and documentation. You could drive features like referral-to-admission pipelines, live census dashboards, UR-aware
What is Kipu Health?
Kipu Health provides an EHR purpose-built for behavioral health and substance use disorder (SUD) treatment across detox, residential, partial hospitalization (PHP), intensive outpatient (IOP), and outpatient levels of care. Core functionality spans admissions and census, clinical documentation, scheduling and groups, eMAR/medication workflows, lab/toxicology interfaces, and revenue cycle support.
Core product areas include:
- Admissions, intake, and census/bed management
- Clinical documentation (assessments, treatment plans, progress notes, group notes)
- Scheduling (individual and group sessions) and attendance tracking
- eMAR and medication management
- Payer management, utilization review (UR), and authorizations
- Billing exports and claims workflows (837/835 via connected channels)
- Reporting and compliance with e-signatures and audit trails
Common data entities:
- Patients/Clients (demographics, identifiers, consents)
- Episodes/Admissions (level of care, program, admit/discharge, bed assignments)
- Providers/Staff (clinicians, counselors, prescribers)
- Schedules and Group Sessions (appointments, rosters, attendance)
- Clinical Documents (assessments, plans, progress/group notes, signatures)
- Payers, Coverages, and Authorizations (units/days, service types, validity dates)
- Orders and Lab Results (toxicology, screening outcomes)
- Claims and Remittances (billing artifacts and statuses)
The Kipu Integration Challenge
Organizations rely on Kipu daily, but turning portal-centric workflows into automated pipelines is hard:
- Portal-first delivery: Many operational workflows (admissions, census, documentation) live in web apps and report exports rather than broad public APIs
- Batch and format diversity: CSV reports, HL7 for labs, and X12/EDI file flows introduce timing windows and delivery complexities
- Multi-episode complexity: Patients can have multiple episodes and level-of-care changes that require careful linkage to documents and billing
- Compliance and signatures: Clinical edits often require reason codes and e-signatures with strict audit trails
- SSO/MFA and access models: Enterprise security (SSO/OAuth, MFA) complicates headless automation
- Payer nuance: Authorization and UR rules vary by payer and level of care, and billing requires specific formats and codes
- Common user feedback: Limited API availability, report timing delays, and integration fees can slow down data access and innovation
How Supergood Creates Kipu 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 patients, episodes, authorizations, schedules, and documentation so you integrate once across Kipu modules
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges CSV, HL7, and X12/SFTP flows with signed URL retrieval and delivery, preserving handoff windows
- Preserves audit trails and signature requirements where edits or postings require compliant reason codes
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your Kipu product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Kipu adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Kipu evolves.
Use Cases
Admissions and Referral Management
- Push preadmission records and convert them to active episodes with level of care and initial bed assignments - Synchronize payer and coverage data from your CRM or eligibility stack - Maintain a single source of truth for demographics and consents
Census and Bed Board
- Pull live census across units and programs for operational dashboards - Track transfers between levels of care within the same episode - Surface capacity to referral teams in real time
Utilization Review and Authorizations
- Retrieve existing authorizations and remaining units/days - Update authorization requests and approvals as UR staff communicate with payers - Prevent over-utilization by validating authorizations before scheduling
Clinical Documentation and Groups
- Post progress notes and group attendance with linkage to the correct episode and treatment plan goals - Collect required signatures and embed audit metadata - Export documentation packets for audits and payer reviews
Billing and Reconciliation
- Bundle verified services into claims with appropriate service lines and facility identifiers - Route claims via your configured channel and track remittance updates - Reconcile census and documentation against billed units/days
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, episodes, authorizations, and documentation artifacts
Security
Encrypted transport, scoped tokens, and audit logging; respects Kipu entitlements and compliance requirements
Webhooks
Optional asynchronous delivery for admission events, authorization updates, and billing artifacts
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume admissions, UR, and documentation 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 Kipu EHR modules subject to your licensing and entitlements. We scope coverage (e.g., admissions/episodes, census, scheduling/groups, clinical documentation, authorizations/UR, billing exports) 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/HL7/EDI timing windows, normalize files, and retrieve signed URLs or delivery confirmations programmatically.
Both, subject to your entitlements. You can create admissions (episodes), attach progress or group notes with required metadata and signatures, and update authorization details while preserving audit trails and reason codes where required.
Supergood operates with encrypted transport, scoped tokens, and detailed audit logging. We align access to your Kipu entitlements and can operate under a BAA, helping your organization meet HIPAA obligations.