PatientEducation
The PatientEducation data model can be used to communicate provider-initiated assignments to your system so the patient can view or act on content within your app. Progress or completion on that assigned material or ad-hoc educational activities that the patient may find and complete can be sent back to the EHR system to keep the provider up-to-date. The PatientEducation data model is usually triggered from the EHR system when the clinician creates or updates a patient’s educational plan.
PatientEducation is commonly used for inpatient settings to help prevent readmissions. For example, educational assignments can be done during an inpatient stay while the patient has free time to prepare them for maintaining health after discharge. However, patient education can be used throughout the patient journey. Educational materials may be used before outpatient visits to adequately inform the patient of what to expect during their appointment. Or, post-visit education may be useful for ensuring care plan adherence like correct medication use, diet, or physical activity.
The PatientEducation data model is generally used when connecting to healthcare organizations with a strong focus on patient education and an EHR system with robust interfacing capabilities. Typically, EHR systems make PatientEducation data available via PPR HL7v2-based messages or their own proprietary APIs.
Newlink
BETAThe New event is used to add education assignments to a patient's chart.
Fields
Meta
Meta.DataModel
String
ReliableRequiredPatientEducation
Meta.EventType
String
ReliableRequiredNew
Meta.EventDateTime
DateTime
ReliableDisplays the UTC date and time that an outgoing request is delivered or an incoming request is received.
ISO 8601 Format
Meta.Test
Boolean
ReliableIndicates whether the request is a test or not.
Meta.Source
String
ReliableContains the information for the system initiating the message, including the source ID and name.
Included in messages from Redox
Meta.Source.ID
String
ReliableIdentifies the system initiating the message. If you have multiple OAuth API keys per environment type, this value is required. If you have only one OAuth API key per environment type, or you're using legacy API keys, this value is optional.
UUID
Meta.Source.Name
String
ReliableDisplays the name of the system initiating the message.
Meta.Destinations[]
Array of Objects
ReliableContains the information for the endpoint(s) receiving the request. A request must contain at least one destination, but asynchronous requests can have more than one destination. Synchronous requests like queries can only support one destination.
Required when sending data to Redox.
Meta.Destinations[].ID
String
ReliableIdentifies the endpoint that the request is directed to.
UUID
Meta.Destinations[].Name
String
ReliableDisplays the name of the endpoint that the request is directed to.
Meta.Logs[]
Array of Objects
ReliableContains the log identifier(s) for the request.
Meta.Logs[].ID
String
ReliableIdentifies the request log(s) that correspond to this request. You can use this value to locate the relevant log in the Redox dashboard for support and reference.
UUID
Meta.Logs[].AttemptID
String
ReliableIdentifies the request log attempt value, which is useful when retries are possible.
UUID
Meta.FacilityCode
String
PossibleCode for the facility related to the message.
Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Patient
Patient.Identifiers[]
Array of Objects
ReliableList of IDs and ID types that identify the patient
Patient.Identifiers[].ID
String
ReliableRequiredID for the patient
Patient.Identifiers[].IDType
String
ReliableRequiredType of ID.
E.g. MRN, EPI
Patient.Demographics.FirstName
String
ReliablePatient's first name
Patient.Demographics.MiddleName
String
PossiblePatient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
Patient.Demographics.LastName
String
ReliablePatient's last name
Patient.Demographics.DOB
String
ReliablePatient's date of birth.
In ISO 8601 format
Patient.Demographics.SSN
String
ProbablePatient's social security number
Patient.Demographics.Sex
String
ReliableValueSetPatient's sex
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Race
String
PossibleValueSetPatient's race
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.IsHispanic
Boolean
PossibleValueSetIndicates if the patient is of hispanic origin.
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Religion
String
PossibleValueSetPatient's religious affiliation
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.MaritalStatus
String
PossibleValueSetPatient's marital status
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.IsDeceased
Boolean
PossibleIndicates if the patient is deceased
Patient.Demographics.DeathDateTime
DateTime
PossibleDate and Time the patient was proclaimed deceased.
ISO 8601 Format
Patient.Demographics.PhoneNumber.Home
String
ProbablePatient's home phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.PhoneNumber.Office
String
ProbablePatient's office phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.PhoneNumber.Mobile
String
ProbablePatient's mobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.EmailAddresses[]
Array of Strings
ProbablePatient's email address(es)
Patient.Demographics.Language
String
PossibleValueSetPatient's primary spoken language
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Citizenship[]
Array of strings
PossibleValueSetPatient's nation(s) of citizenship
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Address
Object
ProbablePatient's home address
Patient.Demographics.Address.StreetAddress
String
ProbableStreet address
Patient.Demographics.Address.City
String
ProbableCity
Patient.Demographics.Address.State
String
ProbableState
Patient.Demographics.Address.ZIP
String
ProbableZIP
Patient.Demographics.Address.County
String
PossibleCounty
Patient.Demographics.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Notes[]
Array of strings
PossiblePatient-level notes
Visit
Visit.VisitNumber
String
ReliableVisit Number.
Unique ID of a single visit
Visit.AccountNumber
String
PossibleAccount Number.
An ID that can span several visits often related to the same issue - pregnancy, surgeries, research study, etc.
Visit.PatientClass
String
ProbablePatient class is used in many EHRs to determine where to put the patient.
Examples: Inpatient, Outpatient, Emergency
Visit.VisitDateTime
String
PossibleDateTime of visit or the arrival time of the visit or admission.
ISO 8601 Format
Visit.AttendingProvider.NPI
String
ProbableNPI of the attending provider
Visit.AttendingProvider.ID
String
ProbableID of the attending provider.
This ID is often required for Inpatient Visits.
Visit.AttendingProvider.IDType
String
ProbableID type of the ID for the attending provider
Visit.AttendingProvider.FirstName
String
PossibleFirst name of the attending provider
Visit.AttendingProvider.LastName
String
PossibleLast name of the attending provider
Visit.AttendingProvider.Credentials[]
Array of Strings
PossibleList of credentials for the attending provider.
e.g. MD, PhD
Visit.AttendingProvider.Address
Object
PossibleProvider's address
Visit.AttendingProvider.Address.StreetAddress
String
PossibleStreet address
Visit.AttendingProvider.Address.City
String
PossibleCity
Visit.AttendingProvider.Address.State
String
PossibleState
Visit.AttendingProvider.Address.ZIP
String
PossibleZIP
Visit.AttendingProvider.Address.County
String
PossibleCounty
Visit.AttendingProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.AttendingProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.AttendingProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.AttendingProvider.Location
Object
PossibleProvider's location
Visit.AttendingProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.AttendingProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.AttendingProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.AttendingProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.AttendingProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AttendingProvider.Location.Department
String
PossibleDepartment
Visit.AttendingProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.AttendingProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.AttendingProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AttendingProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.ConsultingProvider.NPI
String
PossibleNPI of the consulting provider
Visit.ConsultingProvider.ID
String
PossibleID of the consulting provider.
This ID is often required for Inpatient Visits.
Visit.ConsultingProvider.IDType
String
PossibleID type of the ID for the consulting provider
Visit.ConsultingProvider.FirstName
String
PossibleFirst name of the consulting provider
Visit.ConsultingProvider.LastName
String
PossibleLast name of the consulting provider
Visit.ConsultingProvider.Credentials[]
Array of Strings
PossibleList of credentials for the consulting provider.
e.g. MD, PhD
Visit.ConsultingProvider.Address
Object
PossibleProvider's address
Visit.ConsultingProvider.Address.StreetAddress
String
PossibleStreet address
Visit.ConsultingProvider.Address.City
String
PossibleCity
Visit.ConsultingProvider.Address.State
String
PossibleState
Visit.ConsultingProvider.Address.ZIP
String
PossibleZIP
Visit.ConsultingProvider.Address.County
String
PossibleCounty
Visit.ConsultingProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.ConsultingProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.ConsultingProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.ConsultingProvider.Location
Object
PossibleProvider's location
Visit.ConsultingProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.ConsultingProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.ConsultingProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.ConsultingProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.ConsultingProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ConsultingProvider.Location.Department
String
PossibleDepartment
Visit.ConsultingProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.ConsultingProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.ConsultingProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ConsultingProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.ReferringProvider.NPI
String
PossibleNPI of the referring provider
Visit.ReferringProvider.ID
String
PossibleID of the referring provider.
This ID is often required for Inpatient Visits.
Visit.ReferringProvider.IDType
String
PossibleID type of the ID for the referring provider
Visit.ReferringProvider.FirstName
String
PossibleFirst name of the referring provider
Visit.ReferringProvider.LastName
String
PossibleLast name of the referring provider
Visit.ReferringProvider.Credentials[]
Array of Strings
PossibleList of credentials for the referring provider.
e.g. MD, PhD
Visit.ReferringProvider.Address
Object
PossibleProvider's address
Visit.ReferringProvider.Address.StreetAddress
String
PossibleStreet address
Visit.ReferringProvider.Address.City
String
PossibleCity
Visit.ReferringProvider.Address.State
String
PossibleState
Visit.ReferringProvider.Address.ZIP
String
PossibleZIP
Visit.ReferringProvider.Address.County
String
PossibleCounty
Visit.ReferringProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.ReferringProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.ReferringProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.ReferringProvider.Location
Object
PossibleProvider's location
Visit.ReferringProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.ReferringProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.ReferringProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.ReferringProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.ReferringProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ReferringProvider.Location.Department
String
PossibleDepartment
Visit.ReferringProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.ReferringProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.ReferringProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ReferringProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.Location
Object
ProbableLocation of the visit
Visit.Location.Type
String
ProbableType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.Location.Facility
String
ProbableFacility.
Example: Community Hospital
Visit.Location.FacilityIdentifiers[]
Array of Objects
ProbableList of IDs specific to this facility
Visit.Location.FacilityIdentifiers[].ID
String
ProbableAn ID specific to this facility
Visit.Location.FacilityIdentifiers[].IDType
String
ProbableThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.Location.Department
String
ProbableDepartment
Visit.Location.DepartmentIdentifiers[]
Array of Objects
ProbableList of IDs specific to this department
Visit.Location.DepartmentIdentifiers[].ID
String
ProbableAn ID specific to this department
Visit.Location.DepartmentIdentifiers[].IDType
String
ProbableThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.Location.Room
String
ProbableRoom.
Example: 136
Visit.Location.Bed
String
ProbableBed.
Example: B
Education
Education[]
Array of Objects
ReliableEducation concepts
Education[].Subject
Object
ProbableSubject of the education concept
Education[].Subject.Code
String
ProbableRequiredCode for the education subject
Education[].Subject.Codeset
String
ProbableCode set used to identify the education subject
Education[].Subject.Description
String
ProbableDescription of the education subject
Education[].InstanceID
String
PossibleUnique ID that is assigned to the instance of the education resource
Education[].CreatedDateTime
String
PossibleThe date and time the instance of the education resource was assigned.
ISO 8601 format
Education[].Status
String
PossibleThe status of the instance of the education resource.
Values will be one of the following: Active, Resolved, Deleted
Education[].ActionStatus
String
ProbableThe action taken on the instance of education resource.
Values will be one of the following: Assign, Delete, Update
Education[].ActionDateTime
String
ProbableThe date and time the action was taken on the instance of education resource.
ISO 8601 Format
Education[].Assignments[]
Array of Objects
ReliableList of assigned patient education resources. Education assignments can be videos, handouts, etc.
Education[].Assignments[].Code
String
ReliableCode for the assignment
Education[].Assignments[].Codeset
String
ReliableCode set used to identify the assignment
Education[].Assignments[].Description
String
ReliableDescription of the assignment
Education[].Assignments[].Topic
Object
ProbableTopic of the education assignment
Education[].Assignments[].Topic.Code
String
ProbableCode for the assignment topic
Education[].Assignments[].Topic.Codeset
String
ProbableCode set used to identify the assignment topic
Education[].Assignments[].Topic.Description
String
ProbableDescription of the assignment topic
Education[].Assignments[].InstanceID
String
PossibleUnique ID that is assigned to the instance of the education resource
Education[].Assignments[].CreatedDateTime
String
PossibleThe date and time the instance of the education assignment was created.
ISO 8601 format
Education[].Assignments[].Status
String
PossibleThe status of the instance of the education assignment.
Values will be one of the following: Active, Resolved, Deleted
Education[].Assignments[].ActionStatus
String
ProbableThe action taken on the instance of education assignment.
Values will be one of the following: Assign, Delete, Update
Education[].Assignments[].ActionDateTime
String
ProbableThe date and time the action was taken on the instance of education assignment.
ISO 8601 Format
Education[].Assignments[].Assignees[]
Array of Objects
ProbableThe list of assignees associated to the education assignment
Education[].Assignments[].Assignees[].Learner
String
ProbableThe learner type assigned.
Example: Patient, Parent, Caregiver
Education[].Assignments[].Assignees[].ContentType
String
ProbableThe type of content assigned to the learner.
Example: Video, pamphlet, demonstration
Education[].Assignments[].Assignees[].Readiness
String
PossibleAn indication of how eager the learner is to engage in the education.
Example: Eager, Accepting, Unwilling
Education[].Assignments[].Assignees[].Response
String
PossibleThe response of the learner once the education is complete.
Example: Verbalized understanding, Cannot demonstrate understanding
Education[].Assignments[].Assignees[].Notes[]
Array of Strings
PossibleNotes about the assignee's assignment
{
"Meta": {
"DataModel": "PatientEducation",
"EventType": "New",
"EventDateTime": "2024-07-29T16:55:22.999Z",
"Test": true,
"Source": {
"ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
"Name": "Redox Dev Tools"
},
"Destinations": [
{
"ID": "af394f14-b34a-464f-8d24-895f370af4c9",
"Name": "Redox EMR"
}
],
"Logs": [
{
"ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
"AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
}
],
"FacilityCode": null
},
"Patient": {
"Identifiers": [
{
"ID": "994002",
"IDType": "MRN"
}
],
"Demographics": {
"FirstName": "Ase",
"MiddleName": null,
"LastName": "Nzesi",
"DOB": "1978-01-25",
"SSN": "111-22-3333",
"Sex": "Female",
"Race": "Black",
"IsHispanic": false,
"Religion": null,
"MaritalStatus": "Married",
"IsDeceased": false,
"DeathDateTime": null,
"PhoneNumber": {
"Home": "+18088675310",
"Office": null,
"Mobile": null
},
"EmailAddresses": [
"[email protected]"
],
"Language": "en",
"Citizenship": [
"US",
"TH",
"CR"
],
"Address": {
"StreetAddress": "Suan Dok Soi 6/3",
"City": "Chaing Mai",
"State": "Chang Wat Chang Mai",
"ZIP": "50200",
"County": "Amphoe Mueang Chiang Mai",
"Country": "Thailand"
}
},
"Notes": []
},
"Visit": {
"VisitNumber": "3498128348",
"AccountNumber": "12945932",
"PatientClass": "Inpatient",
"VisitDateTime": "2024-07-29T16:55:22.983Z",
"AttendingProvider": {
"NPI": null,
"ID": "426986",
"IDType": "NCT",
"FirstName": "Krittiya",
"LastName": "Somaketarin",
"Credentials": [
"MD"
],
"Address": {
"StreetAddress": "8 Bunrueang Rit Rd",
"City": "Chiang Mai",
"State": "Chang Wat Chiang Mai",
"ZIP": "50200",
"County": "Amphoe Mueang Chiang Mai",
"Country": "Thailand"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+6653920300"
},
"Location": {
"Type": "Department",
"Facility": "Medical Center",
"FacilityIdentifiers": [],
"Department": "Obstetrics and Gynaecology",
"DepartmentIdentifiers": [],
"Room": "446"
}
},
"ConsultingProvider": {
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
"ReferringProvider": {
"NPI": null,
"ID": "12981294",
"IDType": "NCT",
"FirstName": "Carol",
"LastName": "Fujiyoshi",
"Credentials": [
"MD"
],
"Address": {
"StreetAddress": "3-3420 Kuhio Hwy Suite B",
"City": "Lihue",
"State": "HI",
"ZIP": "96766",
"County": "Kauai",
"Country": "United States"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+18082451511"
},
"Location": {
"Type": "Hawaii Pacific Health Hospital",
"Facility": "Wilcox Medical Center",
"FacilityIdentifiers": [],
"Department": "Obstetrics and Gynecology",
"DepartmentIdentifiers": [],
"Room": "32"
}
},
"Location": {
"Type": "Inpatient",
"Facility": "Chiang Mai Ram Hospital",
"FacilityIdentifiers": [],
"Department": "MA",
"DepartmentIdentifiers": [],
"Room": "13",
"Bed": "A"
}
},
"Education": [
{
"Subject": {
"Code": "DN-01",
"Codeset": null,
"Description": "Diet and Nutrition"
},
"InstanceID": "20898465",
"CreatedDateTime": "2024-07-29T16:55:23.761Z",
"Status": "Active",
"ActionStatus": "Assign",
"ActionDateTime": null,
"Assignments": [
{
"Code": "DN-PREG-01A",
"Codeset": "HCOPATED",
"Description": "Diet and Nutrition in Pregnancy - Prenatal Vitamins",
"Topic": {
"Code": "DN-PREG-01",
"Codeset": "HCOPATED",
"Description": "Diet and Nutrition in Pregnancy"
},
"InstanceID": "87300586",
"CreatedDateTime": "2024-07-29T16:55:22.983Z",
"Status": "Active",
"ActionStatus": "Assign",
"ActionDateTime": null,
"Assignees": [
{
"Learner": "Patient",
"ContentType": "Video",
"Readiness": "Eager",
"Response": null,
"Notes": []
}
]
}
]
}
]
}
Updatelink
BETAThe Update event is used to update education assignments in a patient's chart.
Fields
Meta
Meta.DataModel
String
ReliableRequiredPatientEducation
Meta.EventType
String
ReliableRequiredUpdate
Meta.EventDateTime
DateTime
ReliableDisplays the UTC date and time that an outgoing request is delivered or an incoming request is received.
ISO 8601 Format
Meta.Test
Boolean
ReliableIndicates whether the request is a test or not.
Meta.Source
String
ReliableContains the information for the system initiating the message, including the source ID and name.
Included in messages from Redox
Meta.Source.ID
String
ReliableIdentifies the system initiating the message. If you have multiple OAuth API keys per environment type, this value is required. If you have only one OAuth API key per environment type, or you're using legacy API keys, this value is optional.
UUID
Meta.Source.Name
String
ReliableDisplays the name of the system initiating the message.
Meta.Destinations[]
Array of Objects
ReliableContains the information for the endpoint(s) receiving the request. A request must contain at least one destination, but asynchronous requests can have more than one destination. Synchronous requests like queries can only support one destination.
Required when sending data to Redox.
Meta.Destinations[].ID
String
ReliableIdentifies the endpoint that the request is directed to.
UUID
Meta.Destinations[].Name
String
ReliableDisplays the name of the endpoint that the request is directed to.
Meta.Logs[]
Array of Objects
ReliableContains the log identifier(s) for the request.
Meta.Logs[].ID
String
ReliableIdentifies the request log(s) that correspond to this request. You can use this value to locate the relevant log in the Redox dashboard for support and reference.
UUID
Meta.Logs[].AttemptID
String
ReliableIdentifies the request log attempt value, which is useful when retries are possible.
UUID
Meta.FacilityCode
String
PossibleCode for the facility related to the message.
Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Patient
Patient.Identifiers[]
Array of Objects
ReliableList of IDs and ID types that identify the patient
Patient.Identifiers[].ID
String
ReliableRequiredID for the patient
Patient.Identifiers[].IDType
String
ReliableRequiredType of ID.
E.g. MRN, EPI
Patient.Demographics.FirstName
String
ReliablePatient's first name
Patient.Demographics.MiddleName
String
PossiblePatient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
Patient.Demographics.LastName
String
ReliablePatient's last name
Patient.Demographics.DOB
String
ReliablePatient's date of birth.
In ISO 8601 format
Patient.Demographics.SSN
String
ProbablePatient's social security number
Patient.Demographics.Sex
String
ReliableValueSetPatient's sex
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Race
String
PossibleValueSetPatient's race
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.IsHispanic
Boolean
PossibleValueSetIndicates if the patient is of hispanic origin.
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Religion
String
PossibleValueSetPatient's religious affiliation
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.MaritalStatus
String
PossibleValueSetPatient's marital status
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.IsDeceased
Boolean
PossibleIndicates if the patient is deceased
Patient.Demographics.DeathDateTime
DateTime
PossibleDate and Time the patient was proclaimed deceased.
ISO 8601 Format
Patient.Demographics.PhoneNumber.Home
String
ProbablePatient's home phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.PhoneNumber.Office
String
ProbablePatient's office phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.PhoneNumber.Mobile
String
ProbablePatient's mobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.EmailAddresses[]
Array of Strings
ProbablePatient's email address(es)
Patient.Demographics.Language
String
PossibleValueSetPatient's primary spoken language
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Citizenship[]
Array of strings
PossibleValueSetPatient's nation(s) of citizenship
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Address
Object
ProbablePatient's home address
Patient.Demographics.Address.StreetAddress
String
ProbableStreet address
Patient.Demographics.Address.City
String
ProbableCity
Patient.Demographics.Address.State
String
ProbableState
Patient.Demographics.Address.ZIP
String
ProbableZIP
Patient.Demographics.Address.County
String
PossibleCounty
Patient.Demographics.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Notes[]
Array of strings
PossiblePatient-level notes
Visit
Visit.VisitNumber
String
ReliableVisit Number.
Unique ID of a single visit
Visit.AccountNumber
String
PossibleAccount Number.
An ID that can span several visits often related to the same issue - pregnancy, surgeries, research study, etc.
Visit.PatientClass
String
ProbablePatient class is used in many EHRs to determine where to put the patient.
Examples: Inpatient, Outpatient, Emergency
Visit.VisitDateTime
String
PossibleDateTime of visit or the arrival time of the visit or admission.
ISO 8601 Format
Visit.AttendingProvider.NPI
String
ProbableNPI of the attending provider
Visit.AttendingProvider.ID
String
ProbableID of the attending provider.
This ID is often required for Inpatient Visits.
Visit.AttendingProvider.IDType
String
ProbableID type of the ID for the attending provider
Visit.AttendingProvider.FirstName
String
PossibleFirst name of the attending provider
Visit.AttendingProvider.LastName
String
PossibleLast name of the attending provider
Visit.AttendingProvider.Credentials[]
Array of Strings
PossibleList of credentials for the attending provider.
e.g. MD, PhD
Visit.AttendingProvider.Address
Object
PossibleProvider's address
Visit.AttendingProvider.Address.StreetAddress
String
PossibleStreet address
Visit.AttendingProvider.Address.City
String
PossibleCity
Visit.AttendingProvider.Address.State
String
PossibleState
Visit.AttendingProvider.Address.ZIP
String
PossibleZIP
Visit.AttendingProvider.Address.County
String
PossibleCounty
Visit.AttendingProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.AttendingProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.AttendingProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.AttendingProvider.Location
Object
PossibleProvider's location
Visit.AttendingProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.AttendingProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.AttendingProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.AttendingProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.AttendingProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AttendingProvider.Location.Department
String
PossibleDepartment
Visit.AttendingProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.AttendingProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.AttendingProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AttendingProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.ConsultingProvider.NPI
String
PossibleNPI of the consulting provider
Visit.ConsultingProvider.ID
String
PossibleID of the consulting provider.
This ID is often required for Inpatient Visits.
Visit.ConsultingProvider.IDType
String
PossibleID type of the ID for the consulting provider
Visit.ConsultingProvider.FirstName
String
PossibleFirst name of the consulting provider
Visit.ConsultingProvider.LastName
String
PossibleLast name of the consulting provider
Visit.ConsultingProvider.Credentials[]
Array of Strings
PossibleList of credentials for the consulting provider.
e.g. MD, PhD
Visit.ConsultingProvider.Address
Object
PossibleProvider's address
Visit.ConsultingProvider.Address.StreetAddress
String
PossibleStreet address
Visit.ConsultingProvider.Address.City
String
PossibleCity
Visit.ConsultingProvider.Address.State
String
PossibleState
Visit.ConsultingProvider.Address.ZIP
String
PossibleZIP
Visit.ConsultingProvider.Address.County
String
PossibleCounty
Visit.ConsultingProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.ConsultingProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.ConsultingProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.ConsultingProvider.Location
Object
PossibleProvider's location
Visit.ConsultingProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.ConsultingProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.ConsultingProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.ConsultingProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.ConsultingProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ConsultingProvider.Location.Department
String
PossibleDepartment
Visit.ConsultingProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.ConsultingProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.ConsultingProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ConsultingProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.ReferringProvider.NPI
String
PossibleNPI of the referring provider
Visit.ReferringProvider.ID
String
PossibleID of the referring provider.
This ID is often required for Inpatient Visits.
Visit.ReferringProvider.IDType
String
PossibleID type of the ID for the referring provider
Visit.ReferringProvider.FirstName
String
PossibleFirst name of the referring provider
Visit.ReferringProvider.LastName
String
PossibleLast name of the referring provider
Visit.ReferringProvider.Credentials[]
Array of Strings
PossibleList of credentials for the referring provider.
e.g. MD, PhD
Visit.ReferringProvider.Address
Object
PossibleProvider's address
Visit.ReferringProvider.Address.StreetAddress
String
PossibleStreet address
Visit.ReferringProvider.Address.City
String
PossibleCity
Visit.ReferringProvider.Address.State
String
PossibleState
Visit.ReferringProvider.Address.ZIP
String
PossibleZIP
Visit.ReferringProvider.Address.County
String
PossibleCounty
Visit.ReferringProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.ReferringProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.ReferringProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.ReferringProvider.Location
Object
PossibleProvider's location
Visit.ReferringProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.ReferringProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.ReferringProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.ReferringProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.ReferringProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ReferringProvider.Location.Department
String
PossibleDepartment
Visit.ReferringProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.ReferringProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.ReferringProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ReferringProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.Location
Object
ProbableLocation of the visit
Visit.Location.Type
String
ProbableType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.Location.Facility
String
ProbableFacility.
Example: Community Hospital
Visit.Location.FacilityIdentifiers[]
Array of Objects
ProbableList of IDs specific to this facility
Visit.Location.FacilityIdentifiers[].ID
String
ProbableAn ID specific to this facility
Visit.Location.FacilityIdentifiers[].IDType
String
ProbableThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.Location.Department
String
ProbableDepartment
Visit.Location.DepartmentIdentifiers[]
Array of Objects
ProbableList of IDs specific to this department
Visit.Location.DepartmentIdentifiers[].ID
String
ProbableAn ID specific to this department
Visit.Location.DepartmentIdentifiers[].IDType
String
ProbableThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.Location.Room
String
ProbableRoom.
Example: 136
Visit.Location.Bed
String
ProbableBed.
Example: B
Education
Education[]
Array of Objects
ReliableEducation concepts
Education[].Subject
Object
ProbableSubject of the education concept
Education[].Subject.Code
String
ProbableRequiredCode for the education subject
Education[].Subject.Codeset
String
ProbableCode set used to identify the education subject
Education[].Subject.Description
String
ProbableDescription of the education subject
Education[].InstanceID
String
PossibleUnique ID that is assigned to the instance of the education resource
Education[].CreatedDateTime
String
PossibleThe date and time the instance of the education resource was assigned.
ISO 8601 format
Education[].Status
String
PossibleThe status of the instance of the education resource.
Values will be one of the following: Active, Resolved, Deleted
Education[].ActionStatus
String
ProbableThe action taken on the instance of education resource.
Values will be one of the following: Assign, Delete, Update
Education[].ActionDateTime
String
ProbableThe date and time the action was taken on the instance of education resource.
ISO 8601 Format
Education[].Assignments[]
Array of Objects
ReliableList of assigned patient education resources. Education assignments can be videos, handouts, etc.
Education[].Assignments[].Code
String
ReliableCode for the assignment
Education[].Assignments[].Codeset
String
ReliableCode set used to identify the assignment
Education[].Assignments[].Description
String
ReliableDescription of the assignment
Education[].Assignments[].Topic
Object
ProbableTopic of the education assignment
Education[].Assignments[].Topic.Code
String
ProbableCode for the assignment topic
Education[].Assignments[].Topic.Codeset
String
ProbableCode set used to identify the assignment topic
Education[].Assignments[].Topic.Description
String
ProbableDescription of the assignment topic
Education[].Assignments[].InstanceID
String
PossibleUnique ID that is assigned to the instance of the education resource
Education[].Assignments[].CreatedDateTime
String
PossibleThe date and time the instance of the education assignment was created.
ISO 8601 format
Education[].Assignments[].Status
String
PossibleThe status of the instance of the education assignment.
Values will be one of the following: Active, Resolved, Deleted
Education[].Assignments[].ActionStatus
String
ProbableThe action taken on the instance of education assignment.
Values will be one of the following: Assign, Delete, Update
Education[].Assignments[].ActionDateTime
String
ProbableThe date and time the action was taken on the instance of education assignment.
ISO 8601 Format
Education[].Assignments[].Assignees[]
Array of Objects
ProbableThe list of assignees associated to the education assignment
Education[].Assignments[].Assignees[].Learner
String
ProbableThe learner type assigned.
Example: Patient, Parent, Caregiver
Education[].Assignments[].Assignees[].ContentType
String
ProbableThe type of content assigned to the learner.
Example: Video, pamphlet, demonstration
Education[].Assignments[].Assignees[].Readiness
String
PossibleAn indication of how eager the learner is to engage in the education.
Example: Eager, Accepting, Unwilling
Education[].Assignments[].Assignees[].Response
String
PossibleThe response of the learner once the education is complete.
Example: Verbalized understanding, Cannot demonstrate understanding
Education[].Assignments[].Assignees[].Notes[]
Array of Strings
PossibleNotes about the assignee's assignment
{
"Meta": {
"DataModel": "PatientEducation",
"EventType": "Update",
"EventDateTime": "2024-07-29T16:55:22.999Z",
"Test": true,
"Source": {
"ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
"Name": "Redox Dev Tools"
},
"Destinations": [
{
"ID": "af394f14-b34a-464f-8d24-895f370af4c9",
"Name": "Redox EMR"
}
],
"Logs": [
{
"ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
"AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
}
],
"FacilityCode": null
},
"Patient": {
"Identifiers": [
{
"ID": "994002",
"IDType": "MRN"
}
],
"Demographics": {
"FirstName": "Ase",
"MiddleName": null,
"LastName": "Nzesi",
"DOB": "1978-01-25",
"SSN": "111-22-3333",
"Sex": "Female",
"Race": "Black",
"IsHispanic": false,
"Religion": null,
"MaritalStatus": "Married",
"IsDeceased": false,
"DeathDateTime": null,
"PhoneNumber": {
"Home": "+18088675310",
"Office": null,
"Mobile": null
},
"EmailAddresses": [
"[email protected]"
],
"Language": "en",
"Citizenship": [
"US",
"TH",
"CR"
],
"Address": {
"StreetAddress": "Suan Dok Soi 6/3",
"City": "Chaing Mai",
"State": "Chang Wat Chang Mai",
"ZIP": "50200",
"County": "Amphoe Mueang Chiang Mai",
"Country": "Thailand"
}
},
"Notes": []
},
"Visit": {
"VisitNumber": "3498128348",
"AccountNumber": "12945932",
"PatientClass": "Inpatient",
"VisitDateTime": "2024-07-29T16:55:22.983Z",
"AttendingProvider": {
"NPI": null,
"ID": "426986",
"IDType": "NCT",
"FirstName": "Krittiya",
"LastName": "Somaketarin",
"Credentials": [
"MD"
],
"Address": {
"StreetAddress": "8 Bunrueang Rit Rd",
"City": "Chiang Mai",
"State": "Chang Wat Chiang Mai",
"ZIP": "50200",
"County": "Amphoe Mueang Chiang Mai",
"Country": "Thailand"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+6653920300"
},
"Location": {
"Type": "Department",
"Facility": "Medical Center",
"FacilityIdentifiers": [],
"Department": "Obstetrics and Gynaecology",
"DepartmentIdentifiers": [],
"Room": "446"
}
},
"ConsultingProvider": {
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
"ReferringProvider": {
"NPI": null,
"ID": "12981294",
"IDType": "NCT",
"FirstName": "Carol",
"LastName": "Fujiyoshi",
"Credentials": [
"MD"
],
"Address": {
"StreetAddress": "3-3420 Kuhio Hwy Suite B",
"City": "Lihue",
"State": "HI",
"ZIP": "96766",
"County": "Kauai",
"Country": "United States"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+18082451511"
},
"Location": {
"Type": "Hawaii Pacific Health Hospital",
"Facility": "Wilcox Medical Center",
"FacilityIdentifiers": [],
"Department": "Obstetrics and Gynecology",
"DepartmentIdentifiers": [],
"Room": "32"
}
},
"Location": {
"Type": "Inpatient",
"Facility": "Chiang Mai Ram Hospital",
"FacilityIdentifiers": [],
"Department": "MA",
"DepartmentIdentifiers": [],
"Room": "13",
"Bed": "A"
}
},
"Education": [
{
"Subject": {
"Code": "DN-01",
"Codeset": null,
"Description": "Diet and Nutrition"
},
"InstanceID": "20898465",
"CreatedDateTime": "2024-07-29T16:55:23.764Z",
"Status": "Active",
"ActionStatus": "Assign",
"ActionDateTime": null,
"Assignments": [
{
"Code": "DN-PREG-01A",
"Codeset": "HCOPATED",
"Description": "Diet and Nutrition in Pregnancy - Prenatal Vitamins",
"Topic": {
"Code": "DN-PREG-01",
"Codeset": "HCOPATED",
"Description": "Diet and Nutrition in Pregnancy"
},
"InstanceID": "87300586",
"CreatedDateTime": "2024-07-29T16:55:22.983Z",
"Status": "Active",
"ActionStatus": "Assign",
"ActionDateTime": null,
"Assignees": [
{
"Learner": "Patient",
"ContentType": "Video",
"Readiness": "Eager",
"Response": null,
"Notes": []
}
]
}
]
}
]
}
Deletelink
BETAThe Delete event is used to remove education assignments from a patient's chart.
Fields
Meta
Meta.DataModel
String
ReliableRequiredPatientEducation
Meta.EventType
String
ReliableRequiredDelete
Meta.EventDateTime
DateTime
ReliableDisplays the UTC date and time that an outgoing request is delivered or an incoming request is received.
ISO 8601 Format
Meta.Test
Boolean
ReliableIndicates whether the request is a test or not.
Meta.Source
String
ReliableContains the information for the system initiating the message, including the source ID and name.
Included in messages from Redox
Meta.Source.ID
String
ReliableIdentifies the system initiating the message. If you have multiple OAuth API keys per environment type, this value is required. If you have only one OAuth API key per environment type, or you're using legacy API keys, this value is optional.
UUID
Meta.Source.Name
String
ReliableDisplays the name of the system initiating the message.
Meta.Destinations[]
Array of Objects
ReliableContains the information for the endpoint(s) receiving the request. A request must contain at least one destination, but asynchronous requests can have more than one destination. Synchronous requests like queries can only support one destination.
Required when sending data to Redox.
Meta.Destinations[].ID
String
ReliableIdentifies the endpoint that the request is directed to.
UUID
Meta.Destinations[].Name
String
ReliableDisplays the name of the endpoint that the request is directed to.
Meta.Logs[]
Array of Objects
ReliableContains the log identifier(s) for the request.
Meta.Logs[].ID
String
ReliableIdentifies the request log(s) that correspond to this request. You can use this value to locate the relevant log in the Redox dashboard for support and reference.
UUID
Meta.Logs[].AttemptID
String
ReliableIdentifies the request log attempt value, which is useful when retries are possible.
UUID
Meta.FacilityCode
String
PossibleCode for the facility related to the message.
Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.
Patient
Patient.Identifiers[]
Array of Objects
ReliableList of IDs and ID types that identify the patient
Patient.Identifiers[].ID
String
ReliableRequiredID for the patient
Patient.Identifiers[].IDType
String
ReliableRequiredType of ID.
E.g. MRN, EPI
Patient.Demographics.FirstName
String
ReliablePatient's first name
Patient.Demographics.MiddleName
String
PossiblePatient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
Patient.Demographics.LastName
String
ReliablePatient's last name
Patient.Demographics.DOB
String
ReliablePatient's date of birth.
In ISO 8601 format
Patient.Demographics.SSN
String
ProbablePatient's social security number
Patient.Demographics.Sex
String
ReliableValueSetPatient's sex
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Race
String
PossibleValueSetPatient's race
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.IsHispanic
Boolean
PossibleValueSetIndicates if the patient is of hispanic origin.
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Religion
String
PossibleValueSetPatient's religious affiliation
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.MaritalStatus
String
PossibleValueSetPatient's marital status
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.IsDeceased
Boolean
PossibleIndicates if the patient is deceased
Patient.Demographics.DeathDateTime
DateTime
PossibleDate and Time the patient was proclaimed deceased.
ISO 8601 Format
Patient.Demographics.PhoneNumber.Home
String
ProbablePatient's home phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.PhoneNumber.Office
String
ProbablePatient's office phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.PhoneNumber.Mobile
String
ProbablePatient's mobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Demographics.EmailAddresses[]
Array of Strings
ProbablePatient's email address(es)
Patient.Demographics.Language
String
PossibleValueSetPatient's primary spoken language
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Citizenship[]
Array of strings
PossibleValueSetPatient's nation(s) of citizenship
-
Additional values may be added by Redox in the future.
-
Patient.Demographics.Address
Object
ProbablePatient's home address
Patient.Demographics.Address.StreetAddress
String
ProbableStreet address
Patient.Demographics.Address.City
String
ProbableCity
Patient.Demographics.Address.State
String
ProbableState
Patient.Demographics.Address.ZIP
String
ProbableZIP
Patient.Demographics.Address.County
String
PossibleCounty
Patient.Demographics.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Notes[]
Array of strings
PossiblePatient-level notes
Visit
Visit.VisitNumber
String
ReliableVisit Number.
Unique ID of a single visit
Visit.AccountNumber
String
PossibleAccount Number.
An ID that can span several visits often related to the same issue - pregnancy, surgeries, research study, etc.
Visit.PatientClass
String
ProbablePatient class is used in many EHRs to determine where to put the patient.
Examples: Inpatient, Outpatient, Emergency
Visit.VisitDateTime
String
PossibleDateTime of visit or the arrival time of the visit or admission.
ISO 8601 Format
Visit.AttendingProvider.NPI
String
ProbableNPI of the attending provider
Visit.AttendingProvider.ID
String
ProbableID of the attending provider.
This ID is often required for Inpatient Visits.
Visit.AttendingProvider.IDType
String
ProbableID type of the ID for the attending provider
Visit.AttendingProvider.FirstName
String
PossibleFirst name of the attending provider
Visit.AttendingProvider.LastName
String
PossibleLast name of the attending provider
Visit.AttendingProvider.Credentials[]
Array of Strings
PossibleList of credentials for the attending provider.
e.g. MD, PhD
Visit.AttendingProvider.Address
Object
PossibleProvider's address
Visit.AttendingProvider.Address.StreetAddress
String
PossibleStreet address
Visit.AttendingProvider.Address.City
String
PossibleCity
Visit.AttendingProvider.Address.State
String
PossibleState
Visit.AttendingProvider.Address.ZIP
String
PossibleZIP
Visit.AttendingProvider.Address.County
String
PossibleCounty
Visit.AttendingProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.AttendingProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.AttendingProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.AttendingProvider.Location
Object
PossibleProvider's location
Visit.AttendingProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.AttendingProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.AttendingProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.AttendingProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.AttendingProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AttendingProvider.Location.Department
String
PossibleDepartment
Visit.AttendingProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.AttendingProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.AttendingProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AttendingProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.ConsultingProvider.NPI
String
PossibleNPI of the consulting provider
Visit.ConsultingProvider.ID
String
PossibleID of the consulting provider.
This ID is often required for Inpatient Visits.
Visit.ConsultingProvider.IDType
String
PossibleID type of the ID for the consulting provider
Visit.ConsultingProvider.FirstName
String
PossibleFirst name of the consulting provider
Visit.ConsultingProvider.LastName
String
PossibleLast name of the consulting provider
Visit.ConsultingProvider.Credentials[]
Array of Strings
PossibleList of credentials for the consulting provider.
e.g. MD, PhD
Visit.ConsultingProvider.Address
Object
PossibleProvider's address
Visit.ConsultingProvider.Address.StreetAddress
String
PossibleStreet address
Visit.ConsultingProvider.Address.City
String
PossibleCity
Visit.ConsultingProvider.Address.State
String
PossibleState
Visit.ConsultingProvider.Address.ZIP
String
PossibleZIP
Visit.ConsultingProvider.Address.County
String
PossibleCounty
Visit.ConsultingProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.ConsultingProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.ConsultingProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.ConsultingProvider.Location
Object
PossibleProvider's location
Visit.ConsultingProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.ConsultingProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.ConsultingProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.ConsultingProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.ConsultingProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ConsultingProvider.Location.Department
String
PossibleDepartment
Visit.ConsultingProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.ConsultingProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.ConsultingProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ConsultingProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.ReferringProvider.NPI
String
PossibleNPI of the referring provider
Visit.ReferringProvider.ID
String
PossibleID of the referring provider.
This ID is often required for Inpatient Visits.
Visit.ReferringProvider.IDType
String
PossibleID type of the ID for the referring provider
Visit.ReferringProvider.FirstName
String
PossibleFirst name of the referring provider
Visit.ReferringProvider.LastName
String
PossibleLast name of the referring provider
Visit.ReferringProvider.Credentials[]
Array of Strings
PossibleList of credentials for the referring provider.
e.g. MD, PhD
Visit.ReferringProvider.Address
Object
PossibleProvider's address
Visit.ReferringProvider.Address.StreetAddress
String
PossibleStreet address
Visit.ReferringProvider.Address.City
String
PossibleCity
Visit.ReferringProvider.Address.State
String
PossibleState
Visit.ReferringProvider.Address.ZIP
String
PossibleZIP
Visit.ReferringProvider.Address.County
String
PossibleCounty
Visit.ReferringProvider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.ReferringProvider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.ReferringProvider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.ReferringProvider.Location
Object
PossibleProvider's location
Visit.ReferringProvider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.ReferringProvider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.ReferringProvider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.ReferringProvider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.ReferringProvider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ReferringProvider.Location.Department
String
PossibleDepartment
Visit.ReferringProvider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.ReferringProvider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.ReferringProvider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.ReferringProvider.Location.Room
String
PossibleRoom.
Example: 136
Visit.Location
Object
ProbableLocation of the visit
Visit.Location.Type
String
ProbableType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.Location.Facility
String
ProbableFacility.
Example: Community Hospital
Visit.Location.FacilityIdentifiers[]
Array of Objects
ProbableList of IDs specific to this facility
Visit.Location.FacilityIdentifiers[].ID
String
ProbableAn ID specific to this facility
Visit.Location.FacilityIdentifiers[].IDType
String
ProbableThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.Location.Department
String
ProbableDepartment
Visit.Location.DepartmentIdentifiers[]
Array of Objects
ProbableList of IDs specific to this department
Visit.Location.DepartmentIdentifiers[].ID
String
ProbableAn ID specific to this department
Visit.Location.DepartmentIdentifiers[].IDType
String
ProbableThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.Location.Room
String
ProbableRoom.
Example: 136
Visit.Location.Bed
String
ProbableBed.
Example: B
Education
Education[]
Array of Objects
ReliableEducation concepts
Education[].Subject
Object
ProbableSubject of the education concept
Education[].Subject.Code
String
ProbableRequiredCode for the education subject
Education[].Subject.Codeset
String
ProbableCode set used to identify the education subject
Education[].Subject.Description
String
ProbableDescription of the education subject
Education[].InstanceID
String
PossibleUnique ID that is assigned to the instance of the education resource
Education[].CreatedDateTime
String
PossibleThe date and time the instance of the education resource was assigned.
ISO 8601 format
Education[].Status
String
PossibleThe status of the instance of the education resource.
Values will be one of the following: Active, Resolved, Deleted
Education[].ActionStatus
String
ProbableThe action taken on the instance of education resource.
Values will be one of the following: Assign, Delete, Update
Education[].ActionDateTime
String
ProbableThe date and time the action was taken on the instance of education resource.
ISO 8601 Format
Education[].Assignments[]
Array of Objects
ReliableList of assigned patient education resources. Education assignments can be videos, handouts, etc.
Education[].Assignments[].Code
String
ReliableCode for the assignment
Education[].Assignments[].Codeset
String
ReliableCode set used to identify the assignment
Education[].Assignments[].Description
String
ReliableDescription of the assignment
Education[].Assignments[].Topic
Object
ProbableTopic of the education assignment
Education[].Assignments[].Topic.Code
String
ProbableCode for the assignment topic
Education[].Assignments[].Topic.Codeset
String
ProbableCode set used to identify the assignment topic
Education[].Assignments[].Topic.Description
String
ProbableDescription of the assignment topic
Education[].Assignments[].InstanceID
String
PossibleUnique ID that is assigned to the instance of the education resource
Education[].Assignments[].CreatedDateTime
String
PossibleThe date and time the instance of the education assignment was created.
ISO 8601 format
Education[].Assignments[].Status
String
PossibleThe status of the instance of the education assignment.
Values will be one of the following: Active, Resolved, Deleted
Education[].Assignments[].ActionStatus
String
ProbableThe action taken on the instance of education assignment.
Values will be one of the following: Assign, Delete, Update
Education[].Assignments[].ActionDateTime
String
ProbableThe date and time the action was taken on the instance of education assignment.
ISO 8601 Format
Education[].Assignments[].Assignees[]
Array of Objects
ProbableThe list of assignees associated to the education assignment
Education[].Assignments[].Assignees[].Learner
String
ProbableThe learner type assigned.
Example: Patient, Parent, Caregiver
Education[].Assignments[].Assignees[].ContentType
String
ProbableThe type of content assigned to the learner.
Example: Video, pamphlet, demonstration
Education[].Assignments[].Assignees[].Readiness
String
PossibleAn indication of how eager the learner is to engage in the education.
Example: Eager, Accepting, Unwilling
Education[].Assignments[].Assignees[].Response
String
PossibleThe response of the learner once the education is complete.
Example: Verbalized understanding, Cannot demonstrate understanding
Education[].Assignments[].Assignees[].Notes[]
Array of Strings
PossibleNotes about the assignee's assignment
{
"Meta": {
"DataModel": "PatientEducation",
"EventType": "Delete",
"EventDateTime": "2024-07-29T16:55:22.999Z",
"Test": true,
"Source": {
"ID": "7ce6f387-c33c-417d-8682-81e83628cbd9",
"Name": "Redox Dev Tools"
},
"Destinations": [
{
"ID": "af394f14-b34a-464f-8d24-895f370af4c9",
"Name": "Redox EMR"
}
],
"Logs": [
{
"ID": "d9f5d293-7110-461e-a875-3beb089e79f3",
"AttemptID": "925d1617-2fe0-468c-a14c-f8c04b572c54"
}
],
"FacilityCode": null
},
"Patient": {
"Identifiers": [
{
"ID": "994002",
"IDType": "MRN"
}
],
"Demographics": {
"FirstName": "Ase",
"MiddleName": null,
"LastName": "Nzesi",
"DOB": "1978-01-25",
"SSN": "111-22-3333",
"Sex": "Female",
"Race": "Black",
"IsHispanic": false,
"Religion": null,
"MaritalStatus": "Married",
"IsDeceased": false,
"DeathDateTime": null,
"PhoneNumber": {
"Home": "+18088675310",
"Office": null,
"Mobile": null
},
"EmailAddresses": [
"[email protected]"
],
"Language": "en",
"Citizenship": [
"US",
"TH",
"CR"
],
"Address": {
"StreetAddress": "Suan Dok Soi 6/3",
"City": "Chaing Mai",
"State": "Chang Wat Chang Mai",
"ZIP": "50200",
"County": "Amphoe Mueang Chiang Mai",
"Country": "Thailand"
}
},
"Notes": []
},
"Visit": {
"VisitNumber": "3498128348",
"AccountNumber": "12945932",
"PatientClass": "Inpatient",
"VisitDateTime": "2024-07-29T16:55:22.983Z",
"AttendingProvider": {
"NPI": null,
"ID": "426986",
"IDType": "NCT",
"FirstName": "Krittiya",
"LastName": "Somaketarin",
"Credentials": [
"MD"
],
"Address": {
"StreetAddress": "8 Bunrueang Rit Rd",
"City": "Chiang Mai",
"State": "Chang Wat Chiang Mai",
"ZIP": "50200",
"County": "Amphoe Mueang Chiang Mai",
"Country": "Thailand"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+6653920300"
},
"Location": {
"Type": "Department",
"Facility": "Medical Center",
"FacilityIdentifiers": [],
"Department": "Obstetrics and Gynaecology",
"DepartmentIdentifiers": [],
"Room": "446"
}
},
"ConsultingProvider": {
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
"ReferringProvider": {
"NPI": null,
"ID": "12981294",
"IDType": "NCT",
"FirstName": "Carol",
"LastName": "Fujiyoshi",
"Credentials": [
"MD"
],
"Address": {
"StreetAddress": "3-3420 Kuhio Hwy Suite B",
"City": "Lihue",
"State": "HI",
"ZIP": "96766",
"County": "Kauai",
"Country": "United States"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+18082451511"
},
"Location": {
"Type": "Hawaii Pacific Health Hospital",
"Facility": "Wilcox Medical Center",
"FacilityIdentifiers": [],
"Department": "Obstetrics and Gynecology",
"DepartmentIdentifiers": [],
"Room": "32"
}
},
"Location": {
"Type": "Inpatient",
"Facility": "Chiang Mai Ram Hospital",
"FacilityIdentifiers": [],
"Department": "MA",
"DepartmentIdentifiers": [],
"Room": "13",
"Bed": "A"
}
},
"Education": [
{
"Subject": {
"Code": "DN-01",
"Codeset": null,
"Description": "Diet and Nutrition"
},
"InstanceID": "20898465",
"CreatedDateTime": "2024-07-29T16:55:23.766Z",
"Status": "Active",
"ActionStatus": "Assign",
"ActionDateTime": null,
"Assignments": [
{
"Code": "DN-PREG-01A",
"Codeset": "HCOPATED",
"Description": "Diet and Nutrition in Pregnancy - Prenatal Vitamins",
"Topic": {
"Code": "DN-PREG-01",
"Codeset": "HCOPATED",
"Description": "Diet and Nutrition in Pregnancy"
},
"InstanceID": "87300586",
"CreatedDateTime": "2024-07-29T16:55:22.983Z",
"Status": "Active",
"ActionStatus": "Assign",
"ActionDateTime": null,
"Assignees": [
{
"Learner": "Patient",
"ContentType": "Video",
"Readiness": "Eager",
"Response": null,
"Notes": []
}
]
}
]
}
]
}