VSP API
Integuru generates a production-ready HTTP API for VSP, the vision benefits carrier, through the 2020source portal that sublease and corporate optometry practices use to verify coverage. 2 verified actions check a patient's eligibility by insured, member id or SSN last four, with dependent lookups and a date of service, and return the signed-in account details, for RCM and front-desk teams.
2
Verified actions live today
<3 sec
Response latency per call
99.9%+
Reliability rate on generated APIs
24/7
On-call maintenance on Production plans
Integration facts
- Authenticates against
- https://2020source.eyefinity.com/
- Authentication
- Login flows, including 2FA, handled by Integuru using your own VSP credentials.
- Approach
- Direct HTTP requests, with no browser automation or RPA involved.
Endpoints
Available actions
Don't see the action you need?
The actions above cover the most common VSP integration patterns, but they're not the full picture. Integuru can build additional workflows for any capability the platform exposes. Our Managed Service handles scoping, building, and maintaining custom actions on your behalf, so just let us know what you need.
Guide
VSP integration guide
Does VSP have a public API?
VSP publishes no developer API for eligibility. Practices verify VSP coverage inside VSP's own practice-management software, which advertises the only direct connection to the carrier, or through the 2020source portal that sublease and corporate optometry practices log into. Integuru generates a production-ready HTTP API from your 2020source login, with 2 verified actions: patient eligibility and the signed-in account.
For an optometry billing team, that leaves a gap between the practice software's bulk verification and everyone else. A sublease inside a retail optical chain, an outsourced RCM firm, or a scheduling tool that wants to confirm benefits at booking time has a 2020source login and nothing programmatic. Integuru calls the portal's own endpoints directly, authenticated, using your own credentials, with the login and any second factor handled for you.
What you can do with the VSP API
The evening before clinic, tomorrow's schedule sits in one tab and 2020source in the other, and every VSP patient on the list means one more form to fill by hand.
Verify a patient before the visit
check_patient_eligibilitytakes the policyholder'sinsured_first_name,insured_last_nameandinsured_date_of_birth, plusmember_idorssn_last_four, and returns eligibility fordate_of_service(default today). Passstate_code(for exampleOH) when the plan is state-specific.- Set
relationshiptodependentand adddependent_first_name,dependent_last_nameanddependent_date_of_birthwhen the patient is a child or spouse on the policy.
Confirm the practice account
get_account_detailsreturns the signed-in 2020source account with no parameters, so a multi-location group can verify which practice a session belongs to before it runs a batch.
Who uses this
Revenue cycle startups that serve optometry and optical retail run check_patient_eligibility for every VSP patient on tomorrow's schedule and write the result back into the EHR through the EyeFinity integration. Front-desk automation tools verify benefits at booking so the patient hears the copay before they arrive. Practice groups that also carry medical plans pair this page with the Availity integration for commercial payers and the Alignment Health integration for Medicare Advantage members. The healthcare industry page covers payer portals and EHRs together.
Setup notes
Integuru authenticates against 2020source.eyefinity.com with your 2020source user. All dates are YYYY-MM-DD. Send member_id when you have it and fall back to ssn_last_four only when you do not; one of the two is required. Run get_account_details once per session in multi-location setups to confirm the practice context.
Get started
Install the CLI and connect your 2020source login:
npm install -g integuru
Or sign in at app.integuru.com, add VSP, and run check_patient_eligibility from the dashboard. Authorizations, claim submission and remittance lookups are built on request through the Managed Service.
Guides in Insurance
Platform API guides in this vertical
Good to know
Before you start
- Can I use it today?
- Yes. Every action listed above has been verified against live VSP traffic. Install the CLI or sign in at app.integuru.com, connect your VSP account, and start calling the endpoints.
- What if VSP changes or breaks?
- On Production plans the Integuru team is on call around the clock, with auth auto-healing included, so target-platform changes get fixed by Integuru rather than by your engineers.
- What does it cost?
- Start on the Free plan at $0/month with 100 API calls/month. Production starts at $499/month with 24/7 on-call maintenance and auth auto-healing.
FAQ