API
Enhanced Lab Order Management with Result Interpretation Filtering (June 2025)
We’ve enhanced the Orders page with new filtering and visualization capabilities for lab test result interpretations, making it easier to identify and prioritize critical patient results.
What’s New
- Interpretation Filter – Filter orders by clinical result interpretation using the new “Interpretation” dropdown filter
- Critical Value Indicators – The orders table now displays visual indicators for orders with critical results
- Enhanced Order Details – Order detail views now include interpretation badges highlighting critical findings
Filter Options
The new Interpretation filter allows you to quickly locate orders based on their clinical assessment:
- Normal – Orders with results within normal reference ranges
- Abnormal – Orders with results outside normal ranges but not critically urgent
- Critical – Orders with results requiring immediate clinical attention
Visual Enhancements
Orders Table
- Critical value indicators help you quickly spot high-priority results that need immediate attention
- Clear visual distinction between normal, abnormal, and critical interpretations
Order Details View
- Prominent badges display the interpretation status for easy identification
- Critical results are highlighted with distinctive styling to ensure they don’t go unnoticed
You can combine the Interpretation filter with existing filters like Order Status, Date Range, and Order Type for more precise result filtering.
This enhancement improves clinical workflow efficiency by enabling healthcare teams to quickly identify and prioritize orders requiring immediate attention.
Introducing Panel Renaming & Archiving (May 2025)
We’ve added more control to how you manage test panels.
Problem in Transit Order Statuses (Mar 2025)
Testkit orders now support two new statuses representing problems in transit. Refer to the lab test lifecycle documentation.
We’re introducing two new statuses for the OrderLowLevelStatus enum (problem_in_transit_lab and problem_in_transit_customer) and two for the OrderStatus enum (collecting_sample.testkit.problem_in_transit_customer and collecting_sample.testkit.problem_in_transit_lab)—and we may make further changes in the future. To ensure future compatibility, we ask that you avoid exhaustive matching on enum values. Code that assumes all current values are exhaustive could break or fail to compile with SDK upgrades.
Here’s how to verify and ensure you benefit from future enhancements:
- Look for areas in your code where you take an action based on the values of a Junction-defined enum. For example, you might have Python code like this:
- Check unknown values in your code paths are handled gracefully—for example, by using default cases. Logging unknown values can help you stay informed.
-
Make sure you’re running the latest version of our SDK.
-
You’re good to go. Once you’ve checked the code paths won’t break if Junction-defined enums start including new values, no further action is needed.
Source Marker Identification for Results (Nov 2024)
Results now feature the source, orderable marker from which they originated. Refer to the documentation
PSC Appointment Scheduling API (Oct 2024)
Walk-in Phlebotomy orders now allow for appointment booking directly with Vital. Refer to the documentation
Phlebotomy Availability API - Start Date Query (Sep 2024)
You can now supply a start_date to the Appointment Availability API.
The API always responds with 14 days worth of slots.
À La Carte Ordering (Sep 2024)
Vital now supports ordering à-la-carte, as well as a revamped ordering flow.
Check out the Ordering documentation.
Partial Results Webhook (Jul 2024)
Vital now supports sending webhooks for partial results, on a team-by-team configuration.
Check out the Partial Results Notifications documentation.
Patient Service Center (PSC) Availability API (Jul 2024)
It is now possible to verify lab PSC availability in regards to a zip code, radius or order.
Check out the Patient Service Center documentation.
Create Lab Tests With Provider IDs (Jun 2024)
It is now possible to create lab tests using the Laboratory’s unique provider id. This allows payloads to be shared across sandbox and production.
Check out the Create a Lab Test documentation.
Ask on Order Entry (AOE) (Jun 2024)
You can now order panels with AOE requirements via the API.
Check out the AOE documentation.