Core
API
Lab Test Result Interpretation Filtering (June 2025)
You can now filter lab test orders by result interpretation using the newinterpretation query parameter in the GET /orders endpoint.
Details
Details
The new filtering capability allows you to query orders based on their clinical interpretation:Query Parameter:
interpretation- Filter by result interpretation of the lab test- Type:
enum<string> | null - Available options:
normal,abnormal,critical - Note: This enum is non-exhaustive
- Type:
interpretation field providing the clinical assessment of the test results:interpretation- Interpretation of the order result- Type:
enum<string> | null - Available options:
normal,abnormal,critical - Note: This enum is non-exhaustive
- Type:
Webhook Management Endpoints (May 2025)
You can now programmatically manage your webhooks via the Webhooks API. The new endpoints allow you to:- CRUD (create/read/update/delete) your webhooks
- Manage webhook headers
- Update webhook secrets
Org Management API is available for the Scale plan.
Team Management Keys (May 2025)
Junction Management API now supports Management Keys (previously Org Keys) that are scoped to one or more Teams. As a recap, there are now two types of Management Keys:| Type | Remarks |
|---|---|
| Org Management Key | Full control of the organization — notably can create or delete Teams. |
| Team Management Key | Scoped control over one or more Teams. But it cannot access Org-level resources or actions, e.g., creating or deleting Teams. |
Details
Details
All Management Keys — Org or Team — are accepted by the
Check out:
X-Management-Key header, as well as the deprecated X-Vital-Org-Key header.Selected customers can now manage Management Keys in the Junction Dashboard through:| Type | Remarks |
|---|---|
| Org Management Key | The Org Config page; accessible via the top-left corner Dropdown Menu. |
| Team Management Key | The Team Config page. |
- the Create Management Key endpoint documentation;
- the List Management Keys endpoint documentation; and
- the Delete Management Key endpoint documentation.
If you intend to create a Team Management Key that binds to 2 or more Teams, you must use the
Create Management Key API endpoint. Junction Dashboard does not
support creating a key for more than one Team.
Note that Management Keys cannot be used as Team API Keys to access the Junction API. However, you can
manage Team API Keys through a Management Key.
Junction Management API is available for the Scale plan.
X-Management-Key header for Junction Management API (April 2025)
Junction Management API now accepts Management Keys (previously Org Keys)
in the X-Management-Key header, in addition to the X-Vital-Org-Key header.
We would continue to support the X-Vital-Org-Key header. Though we recommend moving over to X-Management-Key to avoid
confusion, especially if you do plan to adopt Team Management Keys.
Junction Management API is available for the Scale plan.
Enhanced Historical Data Pull Status Tracking (May 2025)
We’ve added a new “Retrying” state to the Historical Pull Status page and the historical introspection endpoint, helping you distinguish temporary issues from permanent failures. Additionally, failed historical pulls now include extra error information, making troubleshooting easier and more efficient.This applies to connections established after 9th May.
Prepare Team Custom Credentials endpoint (Aug 2024)
The new Prepare Team Custom Credentials endpoint provides instructions for preparation of Bring Your Own OAuth custom credentials. You can use the information to configure things like OAuth callback URI and the Webhook URI (if applicable), before activating it on your Vital Team through the Set Team Custom Credential endpoint.Org Management API is available for the Scale plan.
Azure Event Hub: Flexible routing (Aug 2024)
You can now configure your Azure Event Hub destination in ETL Pipelines to route Vital data events to different Event Hubs based on their event type prefix. Check out the ETL Pipelines - Azure Event Hub documentation.ETL Pipelines are available for the Scale plan.
Azure Event Hubs as ETL Pipeline destination (Jun 2024)
You can now receive events from Vital directly with your Azure Event Hubs. Check out the ETL Pipelines documentation.ETL Pipelines are available for the Scale plan.
Manage Team Brand Information (Apr 2024)
You can now manage Brand Information of your Vital Teams through the Org Management API.Details
Details
Team Brand Information is used in:Check out the Update Team and
Create Team endpoint documentation.
- the Vital-hosted Link widget;
- all user communications Vital Lab Testing sent on your behalf; and
- the Vital-hosted Appointment Booking page for Vital Lab Testing.
Org Management API is available for the Scale plan.
Vital Orgs and Org Management API (Apr 2024)
We have introduced Vital Org, a new level that groups all your Vital Teams. Your Vital Teams have been transparently grouped and migrated to the new structure.Details
Details
We introduced this to provide a unified billing and administrative experience for customers having these use cases:Check out the Org Management API documentation.
- multi-region presence; or
- user organization with diverging team-level configurations.
Org Management API is available for the Scale plan.
New webhook event top-level fields (Mar 2024)
All events now include Team ID, User ID and Client User ID as top-level fields.Details
Details
We introduced this because this helps reduce a Vital User ID -> Client User ID database lookup on your end.Check out the Webhook Event Structure documentation.
Before
Basic event structure
After
Basic event structure
Improved error response for User creation conflicts (Mar 2024)
The Create User endpoint has improved handling of conflicts in Client User ID.Details
Details
We introduced this because the user creation endpoint being idempotent can help
simplify your application logic.When the supplied
client_user_id conflicts with an existing user, the 400 Bad Request response
now includes the Vital User ID (user_id) and the creation date (created_on) of the conflicting user.Check out the Create User endpoint documentation.User Undo Deletion (Feb 2024)
You can now undo user deletion that is still in the 7-day grace period.Details
Details
Check out the User Undo Deletion endpoint documentation.