Kipu Health

Supergood | Kipu Health API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Kipu Health API

Kipu Health is an electronic health record (EHR) platform built for behavioral health and addiction treatment organizations. With an unofficial API, you could create and manage admissions (episodes of care), synchronize patient demographics, track authorizations and utilization, post clinical documentation (including group notes), and automate billing handoffs—without manually exporting reports or navigating portal workflows.

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 scheduling, outcomes monitoring, and clean billing—powered by near real-time data. Many Kipu users report challenges such as limited public API access, reliance on scheduled CSV/HL7 feeds, and integration fees or long timelines for partner connections. A stable API layer addresses these pain points by providing programmatic, authenticated access to the same data they use every day.

Programmatically access admissions, census, authorizations, documentation, and billing workflows in Kipu with a stable REST API. Supergood builds and operates production-grade, unofficial Kipu integrations so your team can automate critical behavioral health pipelines without heavy custom engineering.

With an unofficial API, you could register new admissions with level of care and payer details, sync patient rosters, validate payer authorizations prior to scheduling, attach progress or group notes to the correct episode, and generate billing artifacts from verified services.

If you’re an admissions team, provider group, or revenue cycle operation, integrating your tech stack with Kipu unlocks concrete data flows and features:

  • Pull: Patient profiles, active and historical episodes (admissions/discharges), payer coverages, authorizations with remaining units/days, schedules and group sessions, clinical notes, claim statuses
  • Push: New/updated patients from your CRM, preadmission records and admissions (episodes), bed assignments, group attendance and clinical notes, UR updates (e.g., requested/approved units)
  • Build: Live census and bed board, authorization-aware scheduling and UR workflows, outcomes dashboards, automated 837P/UB-04 assembly and reconciliation

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

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

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_4a1c27",
    "name": "Admissions Manager",
    "entitlements": ["patients", "episodes", "authorizations", "documentation"]
  }
}

Patients

GET /patients: Retrieve patients/clients with demographics, identifiers, and payer coverage. Use filters to scope synchronization windows or programs.

Query parameters

  • updatedSince: ISO 8601 timestamp
  • program: string (e.g., "Residential", "PHP", "IOP")
  • status: string (active, discharged)
  • mrn: string
  • search: string (name or identifier)

Example response

{
  "items": [
    {
      "patientId": "pat_92f1b0",
      "mrn": "MRN-001234",
      "firstName": "Ava",
      "lastName": "Lopez",
      "dateOfBirth": "1990-05-12",
      "sexAtBirth": "F",
      "preferredName": "Ava",
      "contact": {
        "phone": "+1-555-201-9988",
        "email": "[email protected]"
      },
      "address": {
        "line1": "410 Recovery Ln",
        "city": "Tampa",
        "region": "FL",
        "postalCode": "33602"
      },
      "consents": [
        {"type": "treatment", "signedAt": "2026-01-05T14:22:10Z"},
        {"type": "privacy", "signedAt": "2026-01-05T14:22:45Z"}
      ],
      "primaryPayer": {
        "payerId": "payer_florida-bcbs",
        "memberId": "FL12345678",
        "planName": "BCBS PPO"
      },
      "emergencyContacts": [
        {"name": "Maria Lopez", "relationship": "Mother", "phone": "+1-555-222-1100"}
      ],
      "updatedAt": "2026-01-20T18:10:02Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Episodes (Admissions)

POST /episodes: Create a new episode (admission) with level of care, program, payer, and optional initial authorization. Use this to convert a referral or preadmission into an active episode.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/episodes \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "patientId": "pat_92f1b0",
    "program": "Residential",
    "levelOfCare": "Detox",
    "admitDateTime": "2026-01-19T09:30:00Z",
    "referralSource": "Self",
    "attendingProvider": {"npi": "1234567890", "name": "Dr. Patel"},
    "bed": {"unit": "North Wing", "room": "N-203", "bed": "B"},
    "initialDiagnosisCodes": ["F10.20", "F33.1"],
    "payer": {"payerId": "payer_florida-bcbs", "memberId": "FL12345678"},
    "initialAuthorization": {
      "authorizationNumber": "AUTH-2026-0193",
      "serviceType": "Detox",
      "unitsAuthorizedDays": 5,
      "startDate": "2026-01-19",
      "endDate": "2026-01-24"
    },
    "referenceId": "crm-referral-77451"
  }'

Example response

{
  "episodeId": "epi_7c4c90",
  "status": "active",
  "program": "Residential",
  "levelOfCare": "Detox",
  "admitDateTime": "2026-01-19T09:30:00Z",
  "patientId": "pat_92f1b0",
  "referenceId": "crm-referral-77451",
  "createdAt": "2026-01-19T09:31:12Z"
}

PATCH /episodes/{episodeId}/discharge: Discharge an episode with date/time and disposition. Supports compliant reason codes when changing dates.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/episodes/epi_7c4c90/discharge \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "dischargeDateTime": "2026-01-24T13:05:00Z",
    "disposition": "Completed Treatment",
    "aftercarePlan": "Step-down to IOP with weekly therapy.",
    "editReason": {"code": "DOC_CORRECTION", "note": "Aligned to finalized rounding"}
  }'

Example response

{
  "episodeId": "epi_7c4c90",
  "status": "discharged",
  "dischargeDateTime": "2026-01-24T13:05:00Z",
  "disposition": "Completed Treatment",
  "updatedAt": "2026-01-24T13:12:40Z"
}

Authorizations and UR

GET /authorizations: Retrieve patient/payer authorizations for a program or level of care with remaining units/days. Use to validate eligibility and prevent over-utilization.

Query parameters

  • patientId: string
  • payerId: string
  • serviceType: string (e.g., Detox, Residential, PHP, IOP)
  • activeOn: ISO 8601 date
  • episodeId: string

Example response

{
  "items": [
    {
      "authorizationId": "auth_3b21d1",
      "authorizationNumber": "AUTH-2026-0193",
      "patientId": "pat_92f1b0",
      "episodeId": "epi_7c4c90",
      "payerId": "payer_florida-bcbs",
      "serviceType": "Detox",
      "unitsAuthorizedDays": 5,
      "unitsUsedDays": 4,
      "unitsRemainingDays": 1,
      "startDate": "2026-01-19",
      "endDate": "2026-01-24",
      "status": "active",
      "notes": "Concurrent review scheduled on 01/23"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

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, 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

Performance Characteristics

  • 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

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your Kipu product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Kipu products can this integration cover?

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.

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/HL7/EDI timing windows, normalize files, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I post clinical notes or only read data?

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.

Q: How do you handle privacy and compliance?

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.

Ready to automate your Kipu workflows?

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

Get Started →

Read more