AcuityLogic API
AcuityLogic by Eyefinity is a cloud optical software suite that runs point-of-sale, billing and claims, back office, distribution center, and administration for eyecare and optical retail practices. An unofficial API lets you programmatically pull patients, orders, exams, invoices, claims, and inventory—and push updates like new sales orders, claim submissions, and lab orders back into AcuityLogic.
What is AcuityLogic?
AcuityLogic is a cloud optical software suite from Eyefinity (a VSP company) that unifies point-of-sale, billing and claims, back-office operations, distribution-center/lab ordering, and administration for eyecare and optical retail practices. Practices use AcuityLogic to ring up eyewear and contact-lens sales, validate prescriptions and insurance authorizations, calculate benefits against thousands of preloaded carrier plans, submit and track claims, order from labs, manage inventory, and run KPI and commission reporting across single locations and multi-store chains.
Core modules include:
- POS (point-of-sale transactions, eyewear and contact-lens order entry, prescriptions)
- Billing (insurance benefit calculation, claims submission and tracking, patient billing)
- BackOffice (administrative and operational management, KPI and commission reporting)
- DC (distribution center and lab ordering, inventory management)
- Admin (system administration, configuration, and customizable validation parameters)
- XLink (integration with VSP Vision Care, Gateway EDI, DVI, 4PatientCare, ODG, and Frames Data)
Common data entities:
- Patients, Demographics, Insurance Plans, Authorizations, Eligibility
- Sales Orders, POS Transactions, Prescriptions, Segment Heights
- Exams, Encounters, Frames, Lenses, Contact Lenses
- Invoices, Payments, Claims, Remittances, Adjustments
- Lab Orders, Inventory Items, Stock Levels, Vendors
- KPIs, Commission Records, Reports
The AcuityLogic Integration Challenge
Optical practices run daily operations on AcuityLogic, but turning its portal- and POS-driven workflows into API-driven automation is non-trivial:
- No public developer API: AcuityLogic exposes a web/POS interface for staff, not a documented, self-service API for third-party automation
- VSP/Eyefinity ecosystem gates: Much of the data flows through VSP Vision Care and partner integrations (XLink), which require partnership agreements before programmatic access
- Deployment variability: On-premises self-hosted, third-party hosted, and cloud deployments expose different surfaces and network configurations
- Insurance complexity: Thousands of preloaded carrier plans, authorizations, and benefit calculations make claim and eligibility data hard to extract cleanly
- Multi-module spread: POS, Billing, BackOffice, DC, and Admin each carry their own objects, IDs, and lifecycle states that have to be reconciled
- Multi-store chains: Roll-ups across locations require consistent identifiers and per-store entitlements, which generic exports don't preserve
How Supergood Creates AcuityLogic APIs
Supergood reverse-engineers AcuityLogic's authenticated browser and POS flows to deliver a resilient API layer for your practice or chain—across POS, Billing, BackOffice, DC, and Admin—without waiting on a public API or VSP partner gate.
- Handles username/password and MFA securely within a managed session
- Maintains session continuity with automated refresh and change detection
- Normalizes responses across patients, orders, exams, claims, and inventory so you integrate once and rely on consistent objects
- Aligns with your hosting model and per-store entitlements to ensure compliant, location-scoped access
Use AcuityLogic with AI agents: AcuityLogic MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, hosting model, locations, and authentication setup.
- Supergood Generates and Validates Your API
We deliver a production-ready AcuityLogic adapter tailored to your configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as AcuityLogic evolves.
API Endpoints
Authentication
/authenticateAuthenticate to an AcuityLogic tenant using username/password, or MFA, and obtain a session token for downstream calls.
Patient Operations
/patientsList patients with demographics, insurance plans, and authorization details, filtered by location, status, or date.
Orders
/ordersRetrieve sales orders, POS transactions, prescriptions, and segment heights across stores.
Orders
/create_orderCreate a new sales order or POS transaction with eyewear, contact-lens, and prescription details.
Billing
/claimsPull claims, remittances, invoices, and payments with carrier, status, and authorization filters.
Billing
/submit_claimSubmit an insurance claim against a patient's plan and authorization, then track its status.
Inventory
/inventoryRetrieve inventory items, stock levels, frames, and lab order status from the distribution center.
Use Cases
Sync patient and order data into a warehouse
- Pull patients, demographics, and insurance plans across all locations into a single warehouse - Stream POS transactions, sales orders, and prescriptions to downstream BI and analytics tools - Reconcile exam and encounter records with sales orders for a unified patient view
Automate billing and claims workflows
- Submit insurance claims against preloaded carrier plans and track remittances - Pull eligibility and authorization data to validate benefits before sale - Surface denied and pending claims to revenue-cycle and follow-up workflows
Streamline lab ordering and inventory
- Push lab orders to the distribution center and pull fulfillment status back - Sync inventory items, stock levels, and frames data into procurement systems - Trigger reorder workflows when stock falls below configured thresholds
Roll up KPIs and commissions across stores
- Pull KPI and commission records from BackOffice for multi-store reporting - Feed sales and margin metrics into executive dashboards - Reconcile per-store performance against targets without manual exports
Technical Specifications
Authentication
Username/password and MFA handled in a managed, encrypted session
Connectivity
Authenticated browser and POS flows across on-premises, third-party hosted, and cloud deployments
Response format
Normalized JSON across patients, orders, exams, claims, and inventory objects
Rate limits
Adaptive throttling tuned to your tenant to avoid AcuityLogic-side limits
Session management
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, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for new orders, claim status changes, and inventory updates
Latency
Sub-second reads on cached entities; multi-second writes when posting orders and claims
Throughput
Horizontally scaled workers sized to multi-store transaction volume
Reliability
Retry, backoff, and idempotency keys for orders, claims, and lab transactions
Adaptation
Continuous monitoring of AcuityLogic and Eyefinity releases and per-store configuration drift
Frequently asked questions
AcuityLogic does not publish a self-service developer API. Supergood works against your existing authenticated AcuityLogic sessions to deliver a programmatic API layer without waiting on a public API or VSP partner gate.
No. Supergood operates with your own AcuityLogic credentials and entitlements. Partner agreements through XLink or VSP are only needed when you specifically want to consume third-party services brokered through those integrations.
Yes. Supergood adapts to on-premises self-hosted, third-party hosted, and cloud deployments, operating against the same authenticated surfaces with network configuration tuned to your environment.
Yes. Supergood preserves per-store identifiers and entitlements so you can roll up patients, orders, claims, and KPIs across all locations with consistent objects.
Patients, insurance plans and authorizations, sales orders and POS transactions, prescriptions, exams, invoices, payments, claims and remittances, lab orders, inventory, and KPI/commission records across the POS, Billing, BackOffice, DC, and Admin modules.