← Back to all docs

OncoEMR API

OncoEMR is Flatiron Health's cloud-based electronic health record purpose-built for community oncology. This page is an independent design exercise that asks what a well-designed OncoEMR API could look like: the resources it would expose, the authentication it would need, and the workflows it could unlock. Below: a hypothetical endpoint design, the technical requirements a production implementation would face, the use cases programmatic access could serve, and where to start if your team needs this kind of access today.

By Alex KlarfeldJuly 8, 2026
OncoEMR API

This page is an independent analysis by Supergood of what a well-designed OncoEMR API could look like. It draws on publicly available information, vendor materials, and general integration experience in this category. Nothing on this page describes an existing OncoEMR product, and Supergood is not affiliated with or endorsed by the vendor. If the vendor offers an official API, we highly recommend it.

What is OncoEMR?

OncoEMR is Flatiron Health's cloud-based electronic health record purpose-built for community oncology. Practices use it to run oncology-specific clinical workflows, chemotherapy ordering with built-in NCCN Order Templates, AJCC staging, and Flatiron Assist clinical decision support, alongside molecular profiling orders, financial tools like charge generation, HCC code notifications, and biosimilar drug substitution, and MIPS tracking for value-based care. The platform extends to the OncoAir mobile app and CareSpace patient portal, and today serves 4,700+ providers across 220+ community oncology practices, 1,600+ sites of care, and 5M+ patient records.

Core product areas include:

  • Oncology EHR (chemotherapy ordering with NCCN Order Templates, AJCC staging, Flatiron Assist clinical decision support)
  • Molecular profiling (order placement, status tracking, and results viewing)
  • Financial and operations tools (charge generation, HCC code notifications, biosimilar drug substitution)
  • Value-based care (MIPS tracking and reporting)
  • Mobility and engagement (OncoAir mobile app, CareSpace patient portal)

An API for a platform like this would naturally organize around its core data entities:

  • Patients, Demographics, Staging records
  • Treatment plans, Chemotherapy orders, Regimens, Dosing
  • Appointments, Schedules, Visit notes
  • Lab results, Molecular profiling orders and results
  • Charges, Claims, HCC codes

The OncoEMR Integration Challenge

Community oncology practices run chemo ordering, staging, and practice operations on OncoEMR every day, but programmatic access to that data is tightly gated:

  • Registration-walled FHIR docs: Flatiron's FHIR API documentation sits behind a registration-required portal, so you can't even scope an integration without vendor sign-off
  • Paid, compliance-scoped FHIR: Flatiron's certification page notes that FHIR APIs may require additional fees, access is a per-tenant, fee-bearing add-on scoped to ONC certification requirements rather than a full integration surface
  • HL7 through approved vendors only: Non-FHIR integrations run over Flatiron-managed HL7 interfaces restricted to an approved interface-vendor list, with partnered vendors (MaxMD, Surescripts, DrFirst) charging additional one-time and/or annual fees
  • No self-serve surface: No public developer portal, SDKs, or webhooks, there is no way to simply sign up and start building
  • Oncology data complexity: Regimens, chemo orders, dosing, staging, and molecular-profiling results carry oncology-specific structures that generic EHR integrations don't model
  • PHI and compliance constraints: Cancer-patient data demands HIPAA-aligned access controls and audit trails

What a OncoEMR API Could Look Like

If OncoEMR exposed a modern, general-purpose API, the integration challenges above suggest what it would need to get right. This is a design sketch, not documentation of anything that exists today:

  • First-class authentication: session handling with support for MFA and enterprise sign-on where the platform uses them
  • Consistent resources: normalized JSON schemas and pagination across the platform's core objects
  • Reliable writes: idempotency keys and validation that mirrors the platform's own workflow rules
  • Entitlement awareness: endpoints scoped to what each customer's licensing actually permits

The endpoint sketches, technical requirements, and use cases below flesh out this hypothetical design.

How AI agents could connect to software like OncoEMR: MCP servers for software without a public API →

Need This Kind of Access Today?

If your team needs this kind of access today, Supergood builds integrations on request, one customer at a time. We act at the direction of our customers, within the access they already hold. Customers bring their own accounts, licenses, and entitlements. If the vendor offers an official API, we highly recommend it.

  1. Schedule an Integration Assessment
    A 30-minute session to review your product mix, licensing, and authentication model.
  2. Scope the Integration
    We design the access pattern around your workflows and entitlements.
  3. Deploy with Monitoring
    Go live with continuous monitoring as your platforms evolve.

Potential API Endpoints

Authentication

POST/authenticate

Would authenticate to an OncoEMR practice account and obtain a session token for downstream calls.

Patient Operations

GET/patients

Would list patient records with filters for demographics, staging, physician, and site of care.

Scheduling

GET/appointments

Would retrieve appointments and schedules with date-range, provider, and location filters.

Clinical

GET/treatment_plans

Would pull treatment plans, regimens, and chemotherapy orders with status and dosing details.

Clinical

GET/orders

Would retrieve lab and molecular profiling orders with status tracking and linked results.

Billing

GET/claims

Would pull charges, claims, and HCC code notifications for revenue-cycle reporting.

Use Cases

Sync oncology patient data into your warehouse

- Pull patients, staging records, and treatment plans into a central warehouse - Keep demographics and visit data in sync with downstream analytics and CRM tools - Reconcile records across sites of care for a single patient 360

Automate treatment plan and order tracking

- Track chemotherapy orders and regimen status without portal clicks - Stream molecular profiling order status and results to clinical teams - Flag staging and treatment-plan changes to care coordination workflows

Reconcile charges and claims

- Pull charges, claims, and HCC code notifications into revenue-cycle systems - Match expected reimbursement against submitted claims - Route denied or pending claims to billing staff automatically

Power practice operations reporting

- Feed scheduling and visit volumes to operations dashboards - Monitor MIPS and value-based care measures programmatically - Surface site-of-care utilization across multi-site practices

Technical Requirements

Authentication

Would require practice credentials and MFA handled in a managed, encrypted session

Connectivity

Would build on authenticated OncoEMR web workflows surfaced as a normalized API, no FHIR fees or interface-vendor approvals required

Response format

Normalized JSON across patient, treatment plan, order, appointment, and claim objects

Rate limits

Adaptive throttling tuned to your practice to avoid platform-side limits

Session management

Would need automatic session refresh, MFA replay handling, and credential rotation

Data freshness

Near real-time pulls for patients, orders, and claims with optional scheduled batch syncs

Security

Encrypted credential vault, scoped access tokens, HIPAA-aligned controls, and audit logging

Webhooks

Event-style callbacks for new orders, results, appointment changes, and claim status updates

Latency

Design target: sub-second reads on cached entities; multi-second reads on deep treatment-plan pulls

Throughput

Design target: horizontally scaled workers sized to single-site and multi-site practice volume

Reliability

Retry, backoff, and idempotency keys across scheduling and billing operations

Versioning

Clear versioning and change management would matter as OncoEMR evolves

Frequently asked questions

Yes. PHI flows through an encrypted credential vault with scoped tokens, HIPAA-aligned access controls, and full audit logging so patient and treatment data stays protected.

Availability of official interfaces varies by product, plan, and licensing. Many platforms in this category gate access behind partner programs or paid modules, and there is often no broadly available, self-serve public API. Check the vendor's developer resources for current offerings.

The hard parts would be authentication (MFA, session management, enterprise controls), consistent schemas across the platform's products, and write semantics that reconcile the way the platform's own workflows do.

No. This page is an independent analysis by Supergood and is not affiliated with, sponsored by, or endorsed by the vendor. All product names and trademarks belong to their respective owners and are used for identification only. Nothing here documents an actual OncoEMR product or service.

Supergood acts at the direction of its customers, within the access those customers already have. We respect each customer's agreements with their software vendors, and how those agreements apply to a customer's use is a determination the customer makes. If the vendor offers an official API, we highly recommend it.

Supergood builds managed API access to enterprise software for customers on request, scoped to each customer's own licensing and entitlements. If your team needs programmatic access to a platform like this, schedule an integration assessment to discuss options.

Ready to get a real API?