Patientco

Supergood | Patientco API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Patientco API

Programmatically access patient billing, statements, payments, and payment plan workflows in Patientco with a stable REST API. Supergood builds and operates production-grade, unofficial Patientco integrations so your team can automate revenue cycle and patient financial experience pipelines without heavy custom engineering.

Patientco is a patient financial engagement and payments platform used by health systems, hospitals, and provider groups to deliver consolidated statements, collect payments across channels, manage payment plans and financing, and analyze patient billing performance. With an unofficial API, you could synchronize patient and guarantor accounts, retrieve active statements and balances, process tokenized card/ACH payments, enroll and manage payment plans, and reconcile transactions back to your practice management or EHR—end to end.

If you’re a healthcare tech startup building billing or practice management tools—or a provider organization modernizing the patient financial journey—integrating your product with Patientco unlocks concrete data flows and features:

  • Pull: Patient/guarantor accounts, balances, open statements, itemized charges, transaction histories, settlement batches, payment plan schedules
  • Push: New/updated patient demographics and guarantors, statement metadata, payments (card/ACH/cash/check), refunds/voids, payment plan enrollments, communication preferences
  • Build: Consolidated billing dashboards, autopay with tokenized methods, eligibility-aware payment plans, real-time payment posting and reconciliation, proactive dunning and reminders, estimate-to-statement bridging

What is Patientco?

Patientco provides patient-centric billing and payment capabilities tailored for healthcare. It helps providers present clear, consolidated statements, offer flexible payment options (including plans and financing), process payments securely, and communicate with patients via web, mobile, email, SMS, and paper. Patientco often integrates with EHRs and practice management systems (e.g., Epic, Cerner, athenahealth) for posting and reconciliation.

Core product areas include:

  • Patient/Guarantor Accounts and balances
  • Statement generation, delivery, and tracking
  • Payment processing (card/ACH), refunds, and settlement
  • Payment plans, autopay, and financing options
  • Communications and reminders across channels
  • Analytics and performance reporting for revenue cycle teams

Common data entities:

  • Patients and Guarantors
  • Accounts (linked to MRN/encounters) and balances
  • Statements (periods, itemized charges, delivery status)
  • Payments, refunds, and settlement batches
  • Payment Methods (tokenized card/ACH) and receipts
  • Payment Plans (terms, schedules, next draft dates)
  • Facilities/Locations and service lines
  • Communication events (email/SMS/paper delivery)

The Patientco Integration Challenge

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

  • PCI and HIPAA compliance: Card data tokenization, PII handling, and audit requirements demand careful automation
  • Strong enterprise security: SSO/MFA and network controls complicate headless access for bots and services
  • Portal-first delivery: Statement lifecycle, communications, and posting often live in web apps rather than public APIs
  • Batch timing and settlement windows: Nightly statement postings, payment settlement batches, and bank cutoffs must be respected
  • Cross-system mapping: Accounts, guarantors, and encounters need consistent linkage between Patientco and your EHR/PM
  • Refunds/voids edge cases: Reversals, partial refunds, and chargebacks require precise status handling and audit trails

How Supergood Creates Patientco 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 accounts, statements, payments, and plans so you can integrate once across facilities and merchant setups
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports where applicable with signed URL retrieval and delivery (e.g., statement PDFs, settlement reports)

Use Cases

EHR-to-Patient Billing Synchronization

  • Push patient and guarantor demographics from your EHR/PM into Patientco
  • Maintain a single source of truth for account linkages (MRN, guarantor IDs, encounter references)
  • Continuously reconcile balances, payments, and settlement statuses

Statement Lifecycle Tracking

  • Pull open statements with itemized charges and delivery status
  • Identify patients eligible for plan enrollment or financial assistance
  • Drive outreach via your CRM/engagement tools using Patientco delivery signals

Payment Processing and Reconciliation

  • Post tokenized card/ACH payments programmatically and retrieve receipts
  • Track settlement batches and update your general ledger or PM
  • Manage refunds, voids, and chargebacks with clean audit histories

Payment Plan Orchestration

  • Enroll patients in compliant payment plans with autopay
  • Surface remaining balance, installment schedules, and next draft dates in your portal
  • Automate plan adjustments or cancellations based on EHR/PM events

Communications and Reminders

  • Trigger reminders for due dates, failed drafts, and new statements
  • Respect patient communication preferences and consent
  • Measure engagement and optimize channel strategy

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_12ab45",
    "name": "Billing Admin",
    "entitlements": ["accounts", "statements", "payments"]
  }
}

Accounts

GET /accounts: Retrieve patient/guarantor accounts with balances and linkage to your EHR/PM. Use this to drive statement retrieval, payment posting, and reconciliation.

Query parameters

  • patientId: string
  • mrn: string
  • guarantorId: string
  • facilityId: string
  • activeOn: ISO 8601 date

Example response

{
  "items": [
    {
      "accountId": "acct_7a9321",
      "accountNumber": "A-004918",
      "patient": {
        "patientId": "pat_91c3f2",
        "name": "Jordan Patel",
        "mrn": "MRN-443281"
      },
      "guarantorId": "gua_283ba9",
      "facilityId": "fac_oh_columbus",
      "status": "open",
      "balance": {
        "currency": "USD",
        "amount": 284.50
      },
      "lastStatementDate": "2026-01-10",
      "tags": ["self_pay", "outpatient"]
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Statements

GET /statements: Retrieve statements for an account with delivery status, due dates, and optional PDF links. Use this to power portals and outreach.

Query parameters

  • accountId: string
  • status: string (issued, viewed, paid, partial, void)
  • issuedOn: ISO 8601 date
  • includePdf: boolean

Example response

{
  "items": [
    {
      "statementId": "stmt_5d20c8",
      "statementNumber": "S-2026-000118",
      "accountId": "acct_7a9321",
      "issuedOn": "2026-01-10",
      "periodStart": "2025-12-01",
      "periodEnd": "2025-12-31",
      "dueDate": "2026-02-09",
      "balanceDue": {"currency": "USD", "amount": 284.50},
      "itemizedCharges": [
        {"code": "99213", "description": "Office Visit", "amount": 180.00},
        {"code": "80061", "description": "Lipid Panel", "amount": 104.50}
      ],
      "deliveryChannels": ["email", "paper"],
      "status": "issued",
      "pdfUrl": "https://download.patientco.example/signed/abc123..."
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Payments

POST /payments: Create a payment against an account or a specific statement. Supports tokenized card/ACH and returns receipt artifacts for reconciliation.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/payments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "accountId": "acct_7a9321",
    "statementId": "stmt_5d20c8",
    "amount": {"currency": "USD", "value": 100.00},
    "method": {
      "type": "card",
      "token": "tok_visa_ending_4242",
      "last4": "4242"
    },
    "source": "patient_portal",
    "applyStrategy": "account_level",
    "receiptEmail": "[email protected]",
    "referenceId": "ehr-invoice-42391"
  }'

Example response

{
  "paymentId": "pay_81ef40",
  "status": "captured",
  "postedAt": "2026-01-19T16:05:42Z",
  "settlementBatchId": "set_2026-01-19",
  "receiptUrl": "https://download.patientco.example/signed/receipt_81ef40.pdf",
  "ledgerPostId": "led_9c1382",
  "referenceId": "ehr-invoice-42391"
}

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 accounts, statements, payments, and receipts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Patientco entitlements, HIPAA, and PCI requirements
  • Webhooks: Optional asynchronous delivery for statement updates, payment captures, and settlement changes

Performance Characteristics

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

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Patientco workflows can this integration cover?

Supergood supports commonly used Patientco portal flows subject to your licensing and entitlements. We scope coverage (e.g., accounts/balances, statement retrieval, payment posting, refunds, settlement reporting, payment plan signals) during integration assessment.

Q: How are MFA, SSO, and PCI constraints handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth where enabled. Card/ACH data is handled via tokens only; we never store raw PAN/bank details and maintain audit trails aligned to PCI and HIPAA.

Q: Can I reconcile payments back to my EHR or PM automatically?

Yes. We return receipt artifacts, settlement batch IDs, and posting references so you can update your PM/EHR and general ledger. We can also fetch statement PDFs or batch exports for downstream archiving.

Waystar API - Programmatically access payer and RCM workflows with Supergood

Ready to automate your Patientco workflows?

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

Get Started →

Read more