Quick Start Guide: Sharing Data from a Remote Device

In this guide we will go over the steps necessary for your app to integrate and share remote device data. We will also go over what this workflow will enable your application to do and how you’ll need to configure your application to support it.

Prior to getting started, you’ll want to:

What is Sharing Remote Device Data?

This first requires obtaining enrollment data about the patient in question to get them started in your program and later associate data with that information. After this enrollment, your app wiill then be able to document the device’s measurements and insights and send those back to the patient’s provider organization. This means your app must be capable of two things:

  1. Receiving and persisting Order or Scheduling data from a healthcare organization to know to enroll a patient.
  2. Sending a Media, Notes, or Results message that contains the collected measurements from the monitoring.

Receiving Enrollment Information

To receive Order data from a healthcare organization using Redox, you’ll need to have and endpoint for your application set up as a Destination. Your destination should be able to receive and handle JSON in our Order data model. Below is an example of the sort of message you will be receiving. You test sending data to your Destination using DevTools in your Redox Dashboard.

{
	"Meta": {
		"DataModel": "Order",
		"EventType": "New",
		"EventDateTime": "2020-11-03T07:12:03.888Z",
		"Test": true,
		"Source": {
			"ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
			"Name": "Redox Dev Tools"
		},
		"Destinations": [
			{
				"ID": "af394f14-b34a-464f-8d24-895f370af4c9",
				"Name": "Redox EMR"
			}
		],
		"Message": {
			"ID": 5565
		},
		"Transmission": {
			"ID": 12414
		},
		"FacilityCode": null
	},
	"Patient": {
		"Identifiers": [
			{
				"ID": "0000000001",
				"IDType": "MR"
			},
			{
				"ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
				"IDType": "EHRID"
			},
			{
				"ID": "a1d4ee8aba494ca",
				"IDType": "NIST"
			}
		],
		"Demographics": {
			"FirstName": "Timothy",
			"MiddleName": "Paul",
			"LastName": "Bixby",
			"DOB": "2008-01-06",
			"SSN": "101-01-0001",
			"Sex": "Male",
			"Race": "White",
			"IsHispanic": null,
			"MaritalStatus": "Married",
			"IsDeceased": null,
			"DeathDateTime": null,
			"PhoneNumber": {
				"Home": "+18088675301",
				"Office": null,
				"Mobile": null
			},
			"EmailAddresses": [],
			"Language": "en",
			"Citizenship": [],
			"Address": {
				"StreetAddress": "4762 Hickory Street",
				"City": "Monroe",
				"State": "WI",
				"ZIP": "53566",
				"County": "Green",
				"Country": "US"
			}
		},
		"Notes": []
	},
	"Visit": {
		"VisitNumber": "1234",
		"AccountNumber": null,
		"PatientClass": null,
		"VisitDateTime": "2015-04-21T13:54:49.863Z",
		"AttendingProvider": {
			"ID": "4356789876",
			"IDType": "NPI",
			"FirstName": "Pat",
			"LastName": "Granite",
			"Credentials": [
				"MD"
			],
			"Address": {
				"StreetAddress": "123 Main St.",
				"City": "Madison",
				"State": "WI",
				"ZIP": "53703",
				"County": "Dane",
				"Country": "USA"
			},
			"EmailAddresses": [],
			"PhoneNumber": {
				"Office": "+16085551234"
			},
			"Location": {
				"Type": null,
				"Facility": null,
				"Department": null,
				"Room": null
			}
		},
		"ConsultingProvider": {
			"ID": "2434534567",
			"IDType": "NPI",
			"FirstName": "Sharon",
			"LastName": "Chalk",
			"Credentials": [
				"MD",
				"PhD"
			],
			"Address": {
				"StreetAddress": "312 Maple Dr. Suite 400",
				"City": "Verona",
				"State": "WI",
				"ZIP": "53593",
				"County": "Dane",
				"Country": "USA"
			},
			"EmailAddresses": [],
			"PhoneNumber": {
				"Office": "+16085559999"
			},
			"Location": {
				"Type": null,
				"Facility": null,
				"Department": null,
				"Room": null
			}
		},
		"ReferringProvider": {
			"ID": "4236464757",
			"IDType": "NPI",
			"FirstName": "John",
			"LastName": "Slate",
			"Credentials": [
				"DO"
			],
			"Address": {
				"StreetAddress": "500 First St.",
				"City": "Clayton",
				"State": "MO",
				"ZIP": "63105",
				"County": "Saint Louis",
				"Country": "USA"
			},
			"EmailAddresses": [],
			"PhoneNumber": {
				"Office": "+13145554321"
			},
			"Location": {
				"Type": null,
				"Facility": null,
				"Department": null,
				"Room": null
			}
		},
		"Guarantor": {
			"Number": "10001910",
			"FirstName": "Kent",
			"MiddleName": null,
			"LastName": "Bixby",
			"SSN": null,
			"DOB": null,
			"Sex": null,
			"Spouse": {
				"FirstName": "Barbara",
				"LastName": "Bixby"
			},
			"Address": {
				"StreetAddress": "4762 Hickory Street",
				"City": "Monroe",
				"State": "WI",
				"ZIP": "53566",
				"County": "Green",
				"Country": "USA"
			},
			"PhoneNumber": {
				"Home": null,
				"Business": null,
				"Mobile": null
			},
			"EmailAddresses": [],
			"Type": null,
			"RelationToPatient": "Father",
			"Employer": {
				"Name": "Accelerator Labs",
				"Address": {
					"StreetAddress": "1456 Old Sauk Road",
					"City": "Madison",
					"State": "WI",
					"ZIP": "53719",
					"County": "Dane",
					"Country": "USA"
				},
				"PhoneNumber": "+18083451121"
			}
		},
		"Insurances": [
			{
				"Plan": {
					"ID": "31572",
					"IDType": "Payor ID",
					"Name": "HMO Deductable Plan",
					"Type": null
				},
				"MemberNumber": null,
				"Company": {
					"ID": "60054",
					"IDType": null,
					"Name": "aetna (60054 0131)",
					"Address": {
						"StreetAddress": "PO Box 14080",
						"City": "Lexington",
						"State": "KY",
						"ZIP": "40512-4079",
						"County": "Fayette",
						"Country": "US"
					},
					"PhoneNumber": "+18089541123"
				},
				"GroupNumber": "847025-024-0009",
				"GroupName": "Accelerator Labs",
				"EffectiveDate": "2015-01-01",
				"ExpirationDate": "2020-12-31",
				"PolicyNumber": "9140860055",
				"AgreementType": null,
				"CoverageType": null,
				"Insured": {
					"Identifiers": [],
					"LastName": null,
					"MiddleName": null,
					"FirstName": null,
					"SSN": null,
					"Relationship": null,
					"DOB": null,
					"Sex": null,
					"Address": {
						"StreetAddress": null,
						"City": null,
						"State": null,
						"ZIP": null,
						"County": null,
						"Country": null
					}
				}
			}
		],
		"Location": {
			"Type": "Inpatient",
			"Facility": "RES General Hospital",
			"Department": "3N",
			"Room": "136",
			"Bed": "B"
		}
	},
	"Order": {
		"ID": "157968300",
		"ApplicationOrderID": null,
		"Status": "New",
		"TransactionDateTime": "2015-05-06T06:00:58.872Z",
		"CollectionDateTime": "2015-05-06T06:00:58.872Z",
		"Specimen": {
			"Source": null,
			"BodySite": null,
			"ID": null
		},
		"Procedure": {
			"Code": "49086-2",
			"Codeset": null,
			"Description": "First trimester maternal screen with nuchal translucency panel"
		},
		"Provider": {
			"NPI": "4356789876",
			"ID": "4356789876",
			"IDType": "NPI",
			"FirstName": "Pat",
			"LastName": "Granite",
			"Credentials": [
				"MD"
			],
			"Address": {
				"StreetAddress": "123 Main St.",
				"City": "Madison",
				"State": "WI",
				"ZIP": "53703",
				"County": "Dane",
				"Country": "USA"
			},
			"EmailAddresses": [],
			"PhoneNumber": {
				"Office": "+16085551234"
			},
			"Location": {
				"Type": null,
				"Facility": null,
				"Department": null,
				"Room": null
			}
		},
		"ResultCopyProviders": [],
		"OrderingFacility": {
			"Name": null,
			"Address": {
				"StreetAddress": null,
				"City": null,
				"State": null,
				"ZIP": null,
				"County": null,
				"Country": null
			},
			"PhoneNumber": null
		},
		"Priority": "Stat",
		"Expiration": null,
		"Comments": null,
		"Notes": [],
		"Diagnoses": [
			{
				"Code": "Z31.41",
				"Codeset": "ICD-10",
				"Name": "Encounter for fertility testing",
				"Type": null,
				"DocumentedDateTime": null
			}
		],
		"ClinicalInfo": [
			{
				"Code": "QUESTION001",
				"Codeset": null,
				"Description": "Estimated Due Date",
				"Value": "2015-10-05",
				"Units": null,
				"Abbreviation": null,
				"Notes": []
			},
			{
				"Code": "QUESTION002",
				"Codeset": null,
				"Description": "Ethnicity",
				"Value": "White",
				"Units": null,
				"Abbreviation": "W",
				"Notes": []
			},
			{
				"Code": "QUESTION010",
				"Codeset": null,
				"Description": "Is this a twin pregnancy?",
				"Value": "Singleton",
				"Units": null,
				"Abbreviation": "sng",
				"Notes": []
			},
			{
				"Code": "QUESTION011",
				"Codeset": null,
				"Description": "Dating Method",
				"Value": "LMP",
				"Units": null,
				"Abbreviation": "lmp",
				"Notes": []
			}
		]
	}
}

Now that you have received an Order message, you can leverage that to understand information about a patient and that they’ve enrolled for the device to collect data for.

Sending Collected Device Data

To send data to a healthcare organization, you’ll need to set up your Redox Source. This will be the gateway through which you push out the data to send measurements and insights back to a patient’s care team. The following is an example of a Results message that your app could send to the healthcare organization via the Redox API. You can also download a Postman collection from the Redox Dashboard.

curl \
 -X POST https://api.redoxengine.com/endpoint \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer {{access token from auth process}}" \
 -d '{
   "Meta": {
       "DataModel": "Results",
       "EventType": "NewUnsolicited",
       "EventDateTime": "2020-11-05T19:32:15.691Z",
       "Test": true,
       "Source": {
         "ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
         "Name": "Redox Dev Tools"
       },
       "Destinations": [
         {
             "ID": "af394f14-b34a-464f-8d24-895f370af4c9",
             "Name": "Redox EMR"
         }
       ],
       "Message": {
         "ID": 5565
       },
       "Transmission": {
         "ID": 12414
       },
       "FacilityCode": null
   },
   "Patient": {
       "Identifiers": [
         {
             "ID": "0000000001",
             "IDType": "MR"
         },
         {
             "ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
             "IDType": "EHRID"
         },
         {
             "ID": "a1d4ee8aba494ca",
             "IDType": "NIST"
         }
       ],
       "Demographics": {
         "FirstName": "Timothy",
         "MiddleName": "Paul",
         "LastName": "Bixby",
         "DOB": "2008-01-06",
         "SSN": "101-01-0001",
         "Sex": "Male",
         "Race": "White",
         "IsHispanic": null,
         "MaritalStatus": "Married",
         "IsDeceased": null,
         "DeathDateTime": null,
         "PhoneNumber": {
             "Home": "+18088675301",
             "Office": null,
             "Mobile": null
         },
         "EmailAddresses": [],
         "Language": "en",
         "Citizenship": [],
         "Address": {
             "StreetAddress": "4762 Hickory Street",
             "City": "Monroe",
             "State": "WI",
             "ZIP": "53566",
             "County": "Green",
             "Country": "US"
         }
       },
       "Notes": [],
       "Contacts": [
         {
             "FirstName": "Barbara",
             "MiddleName": null,
             "LastName": "Bixby",
             "Address": {
               "StreetAddress": "4762 Hickory Street",
               "City": "Monroe",
               "State": "WI",
               "ZIP": "53566",
               "County": "Green",
               "Country": "US"
             },
             "PhoneNumber": {
               "Home": "+18088675303",
               "Office": "+17077543758",
               "Mobile": "+19189368865"
             },
             "RelationToPatient": "Mother",
             "EmailAddresses": [
               "[email protected]"
             ],
             "Roles": [
               "Emergency Contact"
             ]
         }
       ]
   },
   "Orders": [
       {
         "ID": null,
         "ApplicationOrderID": "1234",
         "TransactionDateTime": "2015-05-06T06:00:58.872Z",
         "CollectionDateTime": "2015-05-06T06:00:58.872Z",
         "CompletionDateTime": "2015-05-06T06:00:58.872Z",
         "Notes": [],
         "ResultsStatus": "Final",
         "Procedure": {
             "Code": "49086-2",
             "Codeset": null,
             "Description": "First trimester maternal screen with nuchal translucency panel"
         },
         "Provider": {
             "NPI": "4356789876",
             "ID": null,
             "IDType": null,
             "FirstName": "Pat",
             "LastName": "Granite",
             "Credentials": [],
             "Address": {
               "StreetAddress": null,
               "City": null,
               "State": null,
               "ZIP": null,
               "County": null,
               "Country": null
             },
             "EmailAddresses": [],
             "PhoneNumber": {
               "Office": null
             },
             "Location": {
               "Type": null,
               "Facility": null,
               "Department": null,
               "Room": null
             }
         },
         "ResultCopyProviders": [],
         "Status": "Resulted",
         "ResponseFlag": "Associated Segments",
         "Priority": "Stat",
         "Results": [
             {
               "Code": "TEST0001",
               "Codeset": null,
               "Description": "Cystic Fibrosis",
               "RelatedGroupID": null,
               "Specimen": {
                   "Source": null,
                   "BodySite": null,
                   "ID": null
               },
               "Value": "Positive Result",
               "ValueType": "String",
               "CompletionDateTime": null,
               "FileType": null,
               "Units": null,
               "Notes": [
                   "This individual is a carrier for Cystic Fibrosis."
               ],
               "AbnormalFlag": "Very Abnormal",
               "Status": "Final",
               "PrimaryResultsInterpreter": {
                   "NPI": null,
                   "ID": null,
                   "IDType": null,
                   "FirstName": null,
                   "LastName": null,
                   "Credentials": [],
                   "Address": {
                     "StreetAddress": null,
                     "City": null,
                     "State": null,
                     "ZIP": null,
                     "County": null,
                     "Country": null
                   },
                   "EmailAddresses": [],
                   "PhoneNumber": {
                     "Office": null
                   },
                   "Location": {
                     "Type": null,
                     "Facility": null,
                     "Department": null,
                     "Room": null
                   }
               },
               "Producer": {
                   "ID": "RL001",
                   "Name": "Redox Lab WI",
                   "IDType": null,
                   "Address": {
                     "StreetAddress": "111 W. Fairchild",
                     "City": "Madison",
                     "State": "WI",
                     "ZIP": "53703",
                     "County": "Dane",
                     "Country": "USA"
                   }
               },
               "Performer": {
                   "ID": null,
                   "IDType": null,
                   "FirstName": "Bob",
                   "LastName": "Smith",
                   "Credentials": [
                     "MD"
                   ],
                   "Address": {
                     "StreetAddress": null,
                     "City": null,
                     "State": null,
                     "ZIP": null,
                     "County": null,
                     "Country": null
                   },
                   "EmailAddresses": [],
                   "PhoneNumber": {
                     "Office": null
                   },
                   "Location": {
                     "Type": null,
                     "Facility": null,
                     "Department": null,
                     "Room": null
                   }
               },
               "ReferenceRange": {
                   "Low": null,
                   "High": null,
                   "Text": null
               },
               "ObservationMethod": {
                   "Code": null,
                   "Codeset": null,
                   "Description": null
               }
             },
             {
               "Code": "TEST0004",
               "Codeset": null,
               "Description": "Primary Carnitine Deficiency",
               "RelatedGroupID": null,
               "Specimen": {
                   "Source": null,
                   "BodySite": null,
                   "ID": null
               },
               "Value": "Negative Result",
               "ValueType": "String",
               "CompletionDateTime": null,
               "FileType": null,
               "Units": null,
               "Notes": [],
               "AbnormalFlag": "Normal",
               "Status": "Final",
               "PrimaryResultsInterpreter": {
                   "NPI": null,
                   "ID": null,
                   "IDType": null,
                   "FirstName": null,
                   "LastName": null,
                   "Credentials": [],
                   "Address": {
                     "StreetAddress": null,
                     "City": null,
                     "State": null,
                     "ZIP": null,
                     "County": null,
                     "Country": null
                   },
                   "EmailAddresses": [],
                   "PhoneNumber": {
                     "Office": null
                   },
                   "Location": {
                     "Type": null,
                     "Facility": null,
                     "Department": null,
                     "Room": null
                   }
               },
               "Producer": {
                   "ID": "RL001",
                   "Name": "Redox Lab WI",
                   "IDType": null,
                   "Address": {
                     "StreetAddress": "111 W. Fairchild",
                     "City": "Madison",
                     "State": "WI",
                     "ZIP": "53703",
                     "County": "Dane",
                     "Country": "USA"
                   }
               },
               "Performer": {
                   "ID": null,
                   "IDType": null,
                   "FirstName": "Bob",
                   "LastName": "Smith",
                   "Credentials": [
                     "MD"
                   ],
                   "Address": {
                     "StreetAddress": null,
                     "City": null,
                     "State": null,
                     "ZIP": null,
                     "County": null,
                     "Country": null
                   },
                   "EmailAddresses": [],
                   "PhoneNumber": {
                     "Office": null
                   },
                   "Location": {
                     "Type": null,
                     "Facility": null,
                     "Department": null,
                     "Room": null
                   }
               },
               "ReferenceRange": {
                   "Low": null,
                   "High": null,
                   "Text": null
               },
               "ObservationMethod": {
                   "Code": null,
                   "Codeset": null,
                   "Description": null
               }
             }
         ]
       }
   ],
   "Visit": {
       "VisitDateTime": null,
       "VisitNumber": null,
       "AccountNumber": null,
       "PatientClass": null,
       "Location": {
         "Type": null,
         "Facility": null,
         "Department": null,
         "Room": null,
         "Bed": null
       },
       "AttendingProvider": {
         "ID": null,
         "IDType": null,
         "FirstName": null,
         "LastName": null,
         "Credentials": [],
         "Address": {
             "StreetAddress": null,
             "City": null,
             "State": null,
             "ZIP": null,
             "County": null,
             "Country": null
         },
         "EmailAddresses": [],
         "PhoneNumber": {
             "Office": null
         },
         "Location": {
             "Type": null,
             "Facility": null,
             "Department": null,
             "Room": null
         }
       },
       "ReferringProvider": {
         "ID": null,
         "IDType": null,
         "FirstName": null,
         "LastName": null,
         "Credentials": [],
         "Address": {
             "StreetAddress": null,
             "City": null,
             "State": null,
             "ZIP": null,
             "County": null,
             "Country": null
         },
         "EmailAddresses": [],
         "PhoneNumber": {
             "Office": null
         },
         "Location": {
             "Type": null,
             "Facility": null,
             "Department": null,
             "Room": null
         }
       }
   }
 }'

Wrapping Up

In this guide, we’ve walked through example messages for each step required to setup the ability for your app to setup and share collected device data with healthcare organizations.

Sign in with your Redox account to access our custom Postman collection, DevTools, and other helpful options to test this workflow out for yourself!