RevolutionEHR API
RevolutionEHR is the leading cloud EHR and practice management platform for optometry, trusted by 13,000+ eye care professionals to run exams, scheduling, billing, claims, optical retail, and patient engagement from one system. An unofficial API lets you programmatically pull patients, exams, appointments, claims, and optical sales data—and push updates like new appointments and patient records back into RevolutionEHR.
What is RevolutionEHR?
RevolutionEHR is a cloud-based EHR and practice management platform built specifically for optometry, consolidating exams, scheduling, billing, payments, patient engagement, and reporting into one eyecare-specific system. Trusted by 13,000+ eye care professionals with a 97% retention rate, it serves independent, group, corporate-affiliated, and multi-location optometry practices along with specialty clinics and educational institutions.
Core product areas include:
- EHR + Practice Management (optometry exams, customizable templates, diagnostic equipment integrations, scheduling)
- RevClear and RevBilling (insurance claim processing and billing services)
- RevPay (integrated patient payment processing)
- RevIntake and RevEngage (online scheduling, intake, and patient engagement)
- RevAspire, RevDirect, and AI Scribe (CMS reporting, provider communication, and automated documentation)
Common data entities:
- Patients, Demographics, Recalls, Patient portal accounts
- Exams, Clinical records, Spectacle and contact lens prescriptions, Diagnostic imaging
- Appointments, Schedules, Intake submissions
- Insurance claims, Eligibility, Remittances, Patient payments
- Optical POS sales, Frame and lens orders, Inventory
The RevolutionEHR Integration Challenge
Optometry practices run their entire clinical and optical-retail system of record inside RevolutionEHR, but getting data in and out programmatically is non-trivial:
- No public developer portal: RevolutionEHR publishes no self-serve API documentation, keys, or sandbox for practices or their vendors
- Compliance-only FHIR: the only documented API is the ONC-mandated SMART on FHIR R4 patient-access endpoint, which practices must contact support to enable and which exposes only patient-access scopes, with bulk export available upon request
- Gated partner ecosystem: integrations for claims, equipment, communication, analytics, and ordering flow through a curated partner list behind a Request a Partnership form and partner-support email—not open connectivity
- No SDKs or webhooks: there is no event stream for new exams, claims, or optical orders, so vendors resort to manual exports and portal clicks
- Optical retail data spread: frames, lens orders, inventory, and POS transactions live alongside clinical records but have no documented programmatic surface
- PHI and compliance constraints: exam records, prescriptions, and claims demand HIPAA-aligned access controls and audit trails
How Supergood Creates RevolutionEHR APIs
Supergood reverse-engineers RevolutionEHR's authenticated workflows to deliver a resilient, normalized API layer for your practice—covering patients, exams, scheduling, claims, and optical retail without waiting on a partnership application or settling for patient-access-only FHIR scopes.
- Handles practice credentials, session continuity, and MFA securely in a managed session
- Maintains sessions with automated refresh and change detection across multi-location practices
- Normalizes responses across patients, exams, appointments, claims, and optical sales so you integrate once and rely on consistent objects
- Aligns with HIPAA-conscious access controls, scoped tokens, and audit logging for PHI
Use RevolutionEHR with AI agents: RevolutionEHR MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your locations, modules, and authentication model. - Supergood Generates and Validates Your API
We deliver a hardened, production-ready RevolutionEHR adapter tailored to your practice configuration. - Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as RevolutionEHR evolves.
Potential API Endpoints
Authentication
/authenticateAuthenticate to a RevolutionEHR practice account and obtain a session token for downstream calls.
Patient Operations
/patientsList patient records with filters for name, date of birth, recall status, and last exam date.
Scheduling
/appointmentsRetrieve appointments and schedules with provider, location, and date-range filters.
Scheduling
/create_appointmentBook a new appointment against a provider's schedule at a given location.
Clinical
/encountersPull exam records, clinical notes, and spectacle or contact lens prescriptions for a patient.
Billing
/submit_claimSubmit an insurance claim and track its status, remittances, and patient balance.
Use Cases
Sync exam and patient data into your systems
- Pull patients, exams, and prescriptions into a central warehouse - Keep demographics and recall status in sync with downstream CRM and marketing tools - Stream new exam records to referral and co-management workflows
Automate claims and revenue cycle work
- Pull claims, eligibility, and remittance data for financial reporting - Match payments against expected reimbursement to surface underpayments - Route rejected or pending claims to staff queues without portal clicks
Connect optical retail and inventory
- Pull frame and lens orders, POS sales, and inventory levels into accounting systems - Trigger reorder workflows when optical inventory falls below thresholds - Reconcile optical revenue against claims and patient payments
Power patient engagement and recalls
- Trigger recall and appointment reminders from real schedule data - Sync intake submissions into the chart before the visit - Surface no-show and reschedule events to engagement platforms
Technical Requirements
Authentication
Practice credentials and MFA handled in a managed, encrypted session
Connectivity
Authenticated RevolutionEHR web workflows surfaced as a normalized API
Response format
Normalized JSON across patient, exam, appointment, claim, and optical sales objects
Rate limits
Adaptive throttling tuned to your practice to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for patients, schedules, 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 exams, appointments, claim status changes, and optical orders
Latency
Sub-second reads on cached entities; multi-second writes when booking appointments and submitting claims
Throughput
Horizontally scaled workers sized to single-location and multi-location practice volume
Reliability
Retry, backoff, and idempotency keys for appointment booking and claim submission
Adaptation
Continuous monitoring of RevolutionEHR releases and practice configuration drift
Frequently asked questions
No. Supergood works with your existing practice credentials and authenticated sessions, so you do not need to wait on a Request a Partnership application to connect to your own data.
RevolutionEHR exposes an ONC-mandated SMART on FHIR R4 patient-access endpoint that practices must ask support to enable, and it is scoped to patient-access data. Supergood covers the operational data that endpoint does not—optical sales, full scheduling, claims workflows, and write operations.
Yes. PHI flows through an encrypted credential vault with scoped tokens, HIPAA-aligned access controls, and full audit logging so exam records, prescriptions, and claims stay protected.
Yes. The API exposes frame and lens orders, POS transactions, and inventory alongside clinical and billing data, so retail and clinical operations reconcile in one place.
Supergood continuously monitors RevolutionEHR releases and your practice configuration, adapting the adapter automatically so your integration keeps running through updates.