Vantis Patient Data Overview

Vantis enables patients to request their data in a JSON format in accordance with requirements for 'Digitale Gesundheitsanwendungen (DiGA)': the HL7® FHIR® format.

In this format, general patient data (e.g. name, birth date, see https://simplifier.net/coreprofilesstu3/patient) are accessible on the top level. Measurement data (e.g. sensor data) is available within so-called extensions. Each extension contains a serialized collection of individual data points such as blood pressure measurements.

Extension

The following data types are provided in the mentioned extensions

DataChunks

contain measurement data collected from sensors, such as blood pressure (BP) or heart rage (HR) measurements.

field description
user_id Owner of the data
recorded_time Transmission time
start_time First entry in content
end_time Last entry in content
data_type Describes the type of content, e.g. BP for blood pressure measurement.
content Contains measurement, json

MedicationReminders

contain information about medication reminders that were once scheduled, and which comprise the evolution of the medication plan.

field description
user_id Owner of the data
reminder_time time when this reminder should trigger, can be None
every A number describing how many skips should be performed before event: e.g. every day
medication A reference to a medication
dose Information regarding dosis
usage_information Information and Settings collected to perform the therapy
reason Description of the reason to take the medication, could be Heart related
scheduling_type Daily, every second day, etc.
time_classification e.g. morning, night, ...
inactive set to true if removed from the plan
creation_time auto set now
deactivation_time set when inactive is set to true

PerformedActivities

contain data regarding performed activities, such as sport activities.

field description
user_id Owner of the data
activity Reference to an activity performed in the App
schedule_date Date this activity was scheduled by the app
event_type type of performed action, e.g. Done
event_time datetime when the activity was performed
additional_information contains the version of the activity, or information specified by the user via e.g. multiple choice

ScheduledActivityCollections

contain data about scheduled activity collections (e.g. sport programs consisting of several exercises).

field description
user_id Owner of the data
activity_collection Id of a collection of activities that was scheduled for the user
start_date Start date of the collection
end_date End date of the collection

ScheduledActivities

contain data about scheduled activities (such as individual sport activities).

field description
user_id Owner of the data
activity Reference to an activity performed in the App
schedule_date Date this activity was scheduled by the app
user_specific_title_list Title for this activity and user
user_specific_categorization_text Categorization for this activity and user
user_specific_max_completions Number of required completion for this activity and user

FoodTrackingEvent

contain data tracked via the Nutrition Tracker.

field description
user_id Owner of the data
food_items List of food items
event_time datetime when the tracking was performed

MedicationTrackingEvent

contain data tracked via the Medication Tracker.

field description
user_id Owner of the data
event_time datetime when the tracking was performed
tracked_medication list of tracked medication
skipped_medication list of medication marked as skipped

SymptomTrackingEvent

contain data regarding tracked Symptoms.

field description
user_id Owner of the data
symptom reference to one of the selectable symptoms
event_time datetime when the tracking was performed
doctor_required Selection, if doctor or call was required, etc.
description Free text provided by the user

UserInformation

contain the last state of personal information provided by the user.

field description
user_id Owner of the data
profile Profile information stated by the user
diagnosis Diagnosis information stated by the user
blood_work Blood work information stated by the user
body_measures Body measure information stated by the user
onboarding Onboarding question answers
scheduling_settings Scheduling information
app_settings General properties
devices Device information

UserActionRecord

contain app usage data.

field description
user_id Owner of the data
event_time datetime when the tracking was performed
action string describing what happened

UserTrackings

contain updates that the user made to their personal information (contained in the UserInformation object).

field description
user_id Owner of the data
created datetime when the tracking was performed
smoking_state Smoking state of the user
ldl_cholesterol_in_mm_dl Updated entry for LDL
hdl_cholesterol_in_mm_dl Updated entry for HDL
weight_in_kg Updated weight
therapy_progress_offset Updated delay
sport_forbidden_until Updated sport forbidden date
exercise_path Update exercise level
course_preference Updated course preference

Example

For reference a minimal, exemplary JSON export is shown below. It contains a single extension, containing a single DataChunk, which in turn contains a single blood pressure measurement:

		{'birthDate': '1960-01-01',
		 'gender': 'female',
		 'identifier': [{'value': 'User_1'}],
		 'name': [{'text': 'Test User'}],
		 'resourceType': 'Patient',
		 'text': {'div': '<!-- This is an exported user -->', 'status': 'generated'}
		 'extension': [{'url': 'https://staging.vantis-app.com/content_media/patient_profile.html', 'valueString': '[{\"model\": \"monitoring.datachunk\", \"pk\": 48476, \"fields\": {\"user_id\": 146, \"recorded_time\": \"2021-08-10T05:13:47.082Z\", \"start_time\": \"2021-08-10T05:13:36Z\", \"end_time\": \"2021-08-10T05:13:36Z\", \"data_type\": \"BP\", \"content\": [{\"systolic\": 107, \"diastolic\": 79, \"heartRate\": 55, \"timestamp\": \"2021-08-10T05:13:36.000Z\", \"dataSource\": \"OMRON\", \"irregularHeartBeat\": false, \"incorrectMeasurement\": false}]}}]']
		    }]}