You use Junction API to:

  • manage users, demographics information and device connections in your Team with the Core API;
  • pull ingested device data and inspect backfill progress through the Data Access API;
  • order lab tests, manage appointments and pull the results through the Lab Testing API; and
  • aggregate ingested device data with the Horizon AI Query API;

For managing Team configuration and Org resources programmatically, see Junction Management API.

Environments

Junction provides two Sandbox environments and two Production environments today:

EnvironmentBase URLTeam API Key Prefix
πŸ‡ΊπŸ‡Έ Production UShttps://api.tryvital.io/pk_us_*
πŸ‡ͺπŸ‡Ί Production EUhttps://api.eu.tryvital.io/pk_eu_*
πŸ‡ΊπŸ‡Έ Sandbox UShttps://api.sandbox.tryvital.io/sk_us_*
πŸ‡ͺπŸ‡Ί Sandbox EUhttps://api.sandbox.eu.tryvital.io/sk_eu_*

Sandbox environments are functionally identical to Production environments, except that:

  1. Each Team can have only up to 50 Users in Sandbox;
  2. You can create Synthetic Device connections connections; and
  3. You can simulate and transition an order through its lifecycle.

Authentication

Junction API accepts Team API Key. You can provision a Team API Key through:

  1. the Team Config page in the Junction Dashboard; or
  2. the Create Team API Key endpoint of the Junction Management API.

Your API requests should present the Team API Key under the X-Vital-API-Key header. For example:

cURL
curl --request GET
  --url 'https://api.tryvital.io/v2/providers'
  --header 'X-Vital-API-Key: <YOUR-TEAM-API-KEY>'

A Management Key used by Junction Management API does not function as Team API Key. However, you can manage Team API Keys through a Management Key.

Junction Mobile SDKs

Junction Mobile SDKs supports two authentication methods:

SchemeAuthorizationRecommended use case
Sign-In TokenUser-scoped accessProduction mobile apps
Team API KeysFull Team data accessProof-of-concept

Refer to the Mobile SDK Authentication documentation for more information.