API
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.