NameDescriptionTypeAdditional information
provider_unique_id

The unique id associated with the participant as assigned by the provider's back-end systems. The provider_unique_id OR mobilehelp_device_id is required.

string

None.

mobilehelp_device_id

The MobileHelp Device ID assigned to the participant.

string

None.

schedule_id

The unique id associated with TouchPoint instance. When posting a result using a question_id, the schedule_id is required unless the question_id corresponds to a vital sign/special type question (weight, blood pressure, oxygen saturation, etc.).

integer

None.

question_id

The unique id associated with question as assigned by TouchPointCare. Either question_id OR question_type is required.

integer

None.

question_type

The type of question when importing vitals using the following format:

  • weight - weight scale results
  • bgm - blood glucose measurement,
  • bgmq - blood glucose qualifier (beore breakfast, after dinner, etc)
  • bpm - heart rate (beats per minute)
  • diastolic - blood pressure diastolic
  • systolic - blood pressure systolic
  • motion - motion sensor trigger
  • oxysat - Pulse Oxygen saturation
  • pulseox - oxygen saturation, heart rate (bpm), and irregular heartbeat indicator in one single call. Format the result value as "SpO2=999,bpm=999,irreg=true|yes|1". Any of the 3 parts are optional so you could leave off the irregular heartbeat and/or bpm if desired.
  • bloodpressure - blood pressure systolic, diastolic, heart rate (bpm), and irregular heartbeat indicator in one single call. Format the result value as "systolic=999,diastolic=999,bpm=999,irreg=true|yes|1". Any of the 4 parts are optional so you could leave off the irregular heartbeat and/or bpm if desired.
  • temp - Temperature
  • rr - Respiratory Rate
  • Spirometry - Spirometry / FEV1
  • literflow - Liter Flow / PEF
  • a1c - A1C reading
  • irreg - Irregular Heartbeat indicator. The result_value for irregular heartbeat should be formatted as either "true", "yes", or "1" to indicate an irregular heartbeat was detected

string

None.

result_value

The numeric value/result of the data. Do not inlude the units (i.e. for a 150 lb weight reading, the result_value should only display 150).

string

Required

result_date

The date/time of the result. Value should be in coordinated Universal Time (UTC) in the following format: YYYY-MM-DD HH:MM:DD:SS

date

Required

reading_input_type

The type of reading gathered.

Possible Values:

  • Manual: DEFAULT - The reading was manually entered or communicated from the participant.
  • Device: Readings was imported directly from a device such as a bluetooth enabled blood pressure, weight scale, etc.
  • Clinician: Reading was taken directly from a reliable device and oversaw directly by a clinician.

string

None.