Notes
The Notes data model is used to send plain text or rich text content to or from an EHR system, especially if you want to display it in the EHR context with advanced text parsing capabilities (e.g., NLP, searching of the chart). Typically this is non-structured documentation about a patient's clinical care. Notes can summarize actions taken in third-party apps and provide context for the patient’s chart in the EHR system. Alternatively, notes created in the EHR system may be sent outbound to apps for reference or analysis.
You can also send files or documents with the Media and Results data models. Learn more about how to send a file with different data models.
EHR systems with robust interfacing capabilities typically support the Notes data model via an MDM HL7v2 interface or proprietary API.
A New event type can be used to trigger a message when a new note or document is added to the patient's chart. The message can contain the actual note content, along with related patient, visit, and provider info. This is different from a QueryResponse, which doesn't include provider info.
Fields
Meta
Meta.DataModel
String
ReliableRequiredNotes
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
ReliableDisplays a unique identifier for the patient visit. We highly recommend including a visit number so the document can be associated with a specific visit.
Visit.AccountNumber
String
PossibleContains an identifier that can span several visits often related to the same patient condition (e.g., surgeries, research study, pregnancy). In other words, the account number can be used to link related visits.
Visit.PatientClass
String
ReliableClassifies the department or type of patient care. Patient class is used in many EHR systems to determine where to put the patient (e.g., inpatient, outpatient, emergency).
Visit.VisitDateTime
String
ReliableDisplays the timestamp for the patient visit or the time that the patient arrived for admission.
ISO 8601 Format
Visit.Location
Object
ProbableDisplays the location of the patient visit. This may be used to validate or to identify your application/device.
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
Visit.AdditionalStaff[]
PossibleContains information about all other staff assigned to the assist with the patient visit. Each may be scheduled individually.
Visit.AdditionalStaff[].ID
String
ProbableID of the Additional staff member.
This ID is often required for Inpatient Visits.
Visit.AdditionalStaff[].IDType
String
ProbableID type of the ID for the Additional staff member
Visit.AdditionalStaff[].FirstName
String
PossibleFirst name of the Additional staff member
Visit.AdditionalStaff[].LastName
String
PossibleLast name of the Additional staff member
Visit.AdditionalStaff[].Credentials[]
Array of Strings
PossibleList of credentials for the Additional staff member.
e.g. MD, PhD
Visit.AdditionalStaff[].Address
Object
PossibleProvider's address
Visit.AdditionalStaff[].Address.StreetAddress
String
PossibleStreet address
Visit.AdditionalStaff[].Address.City
String
PossibleCity
Visit.AdditionalStaff[].Address.State
String
PossibleState
Visit.AdditionalStaff[].Address.ZIP
String
PossibleZIP
Visit.AdditionalStaff[].Address.County
String
PossibleCounty
Visit.AdditionalStaff[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.AdditionalStaff[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.AdditionalStaff[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.AdditionalStaff[].Location
Object
PossibleProvider's location
Visit.AdditionalStaff[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.AdditionalStaff[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.AdditionalStaff[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.AdditionalStaff[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.AdditionalStaff[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AdditionalStaff[].Location.Department
String
PossibleDepartment
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AdditionalStaff[].Location.Room
String
PossibleRoom.
Example: 136
Visit.AdditionalStaff[].Role
Object
ProbableIdentifies an additional staff member.
Visit.AdditionalStaff[].Role.Code
String
ProbableCode for the service
Visit.AdditionalStaff[].Role.Codeset
String
ProbableCode set used to identify the service.
Codeset will be blank for system-defined codes.
Visit.AdditionalStaff[].Role.Description
String
ProbableDescription of the service.
Example: Primary Physician, Technologist, etc.
Note
Note.ContentType
String
ReliableValueSetRequiredDescribes the type of text provided in Note.FileContents.
-
Additional values may be added by Redox in the future.
-
Note.FileContents
String
ProbableContains the content of the file. This should be a Blob URL if the file is referenced. Otherwise, this contains plain or rich text.
If using data on demand, the plain or rich text is stored as base64 encoded data. It gets decoded when responding to a Notes.Query.
Note.FileName
String
ProbableDisplays the name of the document.
Note.FileType
String
ProbableIdentifies the format of the file (e.g., PDF, JPG). Use this if referencing a file with a Redox Blob URL.
Not supported with data on demand.
Note.DocumentType
String
ReliableRequiredClassifies the type of document (e.g., consent form, treatment plan).
Note.DocumentID
String
ReliableRequiredContains the unique identifier for this document. You must have the document ID to update the document later.
This ID is required in order to update the document with Modify messages
Note.DocumentDescription
String
PossibleContains a descriptive label for the document.
Not supported with data on demand.
Note.ServiceDateTime
DateTime
ReliableDisplays the time of the clinical service that the document is related to. For example, for a surgical note, this would be the date/time of the surgery.
Note.DocumentationDateTime
DateTime
ReliableDisplays the timestamp for when the document was finalized or created. For example, a surgeon may enter the surgical note contents after the surgery. This timestamp represents the time the note was saved.
For example, a surgeon may enter the surgical note contents following the surgery. This is the field representing the time the note was saved.
Note.Status
String
ProbableValueSetTDisplays the authenticated status of the document, which can be either Authenticated or In progress. If Authenticated, the related Note.Authenticator field must be populated.
-
Additional values may be added by Redox in the future.
-
Note.Availability
String
ProbableValueSetIndicates whether the document is available for use.
-
Additional values may be added by Redox in the future.
-
Note.Provider.ID
String
ProbableRequiredID of the Provider responsible for the document
Note.Provider.IDType
String
ProbableID type of the ID for the Provider responsible for the document
Note.Provider.FirstName
String
PossibleFirst name of the Provider responsible for the document
Note.Provider.LastName
String
PossibleLast name of the Provider responsible for the document
Note.Provider.Credentials[]
Array of Strings
PossibleList of credentials for the Provider responsible for the document.
e.g. MD, PhD
Note.Provider.Address
Object
PossibleProvider's address
Note.Provider.Address.StreetAddress
String
PossibleStreet address
Note.Provider.Address.City
String
PossibleCity
Note.Provider.Address.State
String
PossibleState
Note.Provider.Address.ZIP
String
PossibleZIP
Note.Provider.Address.County
String
PossibleCounty
Note.Provider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Provider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Provider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Provider.Location
Object
PossibleProvider's location
Note.Provider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Provider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Provider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Provider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Provider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Provider.Location.Department
String
PossibleDepartment
Note.Provider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Provider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Provider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Provider.Location.Room
String
PossibleRoom.
Example: 136
Note.Authenticator.ID
String
ProbableID of the provider who authenticated the document.
This ID is often required for Inpatient Visits.
Note.Authenticator.IDType
String
ProbableID type of the ID for the provider who authenticated the document
Note.Authenticator.FirstName
String
PossibleFirst name of the provider who authenticated the document
Note.Authenticator.LastName
String
PossibleLast name of the provider who authenticated the document
Note.Authenticator.Credentials[]
Array of Strings
PossibleList of credentials for the provider who authenticated the document.
e.g. MD, PhD
Note.Authenticator.Address
Object
PossibleProvider's address
Note.Authenticator.Address.StreetAddress
String
PossibleStreet address
Note.Authenticator.Address.City
String
PossibleCity
Note.Authenticator.Address.State
String
PossibleState
Note.Authenticator.Address.ZIP
String
PossibleZIP
Note.Authenticator.Address.County
String
PossibleCounty
Note.Authenticator.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Authenticator.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Authenticator.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Authenticator.Location
Object
PossibleProvider's location
Note.Authenticator.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Authenticator.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Authenticator.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Authenticator.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Authenticator.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Authenticator.Location.Department
String
PossibleDepartment
Note.Authenticator.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Authenticator.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Authenticator.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Authenticator.Location.Room
String
PossibleRoom.
Example: 136
Note.Notifications[].ID
String
ReliableID of the provider who should be notified.
This ID is often required for Inpatient Visits.
Note.Notifications[].IDType
String
ReliableID type of the ID for the provider who should be notified
Note.Notifications[].FirstName
String
PossibleFirst name of the provider who should be notified
Note.Notifications[].LastName
String
PossibleLast name of the provider who should be notified
Note.Notifications[].Credentials[]
Array of Strings
PossibleList of credentials for the provider who should be notified.
e.g. MD, PhD
Note.Notifications[].Address
Object
PossibleProvider's address
Note.Notifications[].Address.StreetAddress
String
PossibleStreet address
Note.Notifications[].Address.City
String
PossibleCity
Note.Notifications[].Address.State
String
PossibleState
Note.Notifications[].Address.ZIP
String
PossibleZIP
Note.Notifications[].Address.County
String
PossibleCounty
Note.Notifications[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Notifications[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Notifications[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Notifications[].Location
Object
PossibleProvider's location
Note.Notifications[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Notifications[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Notifications[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Notifications[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Notifications[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Notifications[].Location.Department
String
PossibleDepartment
Note.Notifications[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Notifications[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Notifications[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Notifications[].Location.Room
String
PossibleRoom.
Example: 136
Note.Components[].ID
String
PossibleContains the identifier of the discrete note component. This could be either a report ID or document field ID.
Not supported with data on demand.
Note.Components[].Name
String
PossibleDisplays the name of the discrete note component (e.g., severity).
Not supported with data on demand.
Note.Components[].Value
String
PossibleContains the text of the note component, either in plain text or rich text.
Not supported with data on demand.
Note.Components[].Comments
String
PossibleContains any additional comments for the discrete note field.
Not supported with data on demand.
Orders
Orders[].ID
String
PossibleContains the unique identifier of the order request, which is assigned by the system that placed the order.
Not supported with data on demand.
Orders[].Name
String
PossibleDisplays the name of the order, which is assigned by the system that placed the order.
Not supported with data on demand.
{
"Meta": {
"DataModel": "Notes",
"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": "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,
"Religion": null,
"MaritalStatus": "Single",
"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-05-06T06:00:58.872Z",
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null,
"Bed": null
},
"AdditionalStaff": []
},
"Note": {
"ContentType": "Base64 Encoded",
"FileContents": "<...base 64 file contents...>",
"FileName": "SamplePDF-Order Specific Note",
"FileType": null,
"DocumentType": "Empty File",
"DocumentID": "b169267c-10c9-4fe3-91ae-9ckf5703e90l",
"DocumentDescription": null,
"ServiceDateTime": "2015-05-06T06:00:58.872Z",
"DocumentationDateTime": "2015-05-06T06:00:58.872Z",
"Status": null,
"Availability": "Unavailable",
"Provider": {
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
"Authenticator": {
"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
}
},
"Notifications": [
{
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
{
"ID": "8263749385",
"IDType": "NPI",
"FirstName": "Jim",
"LastName": "Mica",
"Credentials": [
"RN"
],
"Address": {
"StreetAddress": "5235 Kennedy Ave.",
"City": "Creve Cour",
"State": "MO",
"ZIP": "63141",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+13145557777"
},
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Components": []
},
"Orders": [
{
"ID": 123456,
"Name": "Stress Test"
}
]
}
A Replace event type can be used to replace a document that was previously added to the patient's chart. The Replace event type isn't supported with data on demand.
Fields
Meta
Meta.DataModel
String
ReliableRequiredNotes
Meta.EventType
String
ReliableRequiredReplace
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
ReliableDisplays a unique identifier for the patient visit. We highly recommend including a visit number so the document can be associated with a specific visit.
Visit.AccountNumber
String
PossibleContains an identifier that can span several visits often related to the same patient condition (e.g., surgeries, research study, pregnancy). In other words, the account number can be used to link related visits.
Visit.PatientClass
String
ReliableClassifies the department or type of patient care. Patient class is used in many EHR systems to determine where to put the patient (e.g., inpatient, outpatient, emergency).
Visit.VisitDateTime
String
ReliableDisplays the timestamp for the patient visit or the time that the patient arrived for admission.
ISO 8601 Format
Visit.Location
Object
ProbableDisplays the location of the patient visit. This may be used to validate or to identify your application/device.
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
Visit.AdditionalStaff[]
PossibleContains information about all other staff assigned to the assist with the patient visit. Each may be scheduled individually.
Visit.AdditionalStaff[].ID
String
ProbableID of the Additional staff member.
This ID is often required for Inpatient Visits.
Visit.AdditionalStaff[].IDType
String
ProbableID type of the ID for the Additional staff member
Visit.AdditionalStaff[].FirstName
String
PossibleFirst name of the Additional staff member
Visit.AdditionalStaff[].LastName
String
PossibleLast name of the Additional staff member
Visit.AdditionalStaff[].Credentials[]
Array of Strings
PossibleList of credentials for the Additional staff member.
e.g. MD, PhD
Visit.AdditionalStaff[].Address
Object
PossibleProvider's address
Visit.AdditionalStaff[].Address.StreetAddress
String
PossibleStreet address
Visit.AdditionalStaff[].Address.City
String
PossibleCity
Visit.AdditionalStaff[].Address.State
String
PossibleState
Visit.AdditionalStaff[].Address.ZIP
String
PossibleZIP
Visit.AdditionalStaff[].Address.County
String
PossibleCounty
Visit.AdditionalStaff[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.AdditionalStaff[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.AdditionalStaff[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.AdditionalStaff[].Location
Object
PossibleProvider's location
Visit.AdditionalStaff[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.AdditionalStaff[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.AdditionalStaff[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.AdditionalStaff[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.AdditionalStaff[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AdditionalStaff[].Location.Department
String
PossibleDepartment
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AdditionalStaff[].Location.Room
String
PossibleRoom.
Example: 136
Visit.AdditionalStaff[].Role
Object
ProbableIdentifies an additional staff member.
Visit.AdditionalStaff[].Role.Code
String
ProbableCode for the service
Visit.AdditionalStaff[].Role.Codeset
String
ProbableCode set used to identify the service.
Codeset will be blank for system-defined codes.
Visit.AdditionalStaff[].Role.Description
String
ProbableDescription of the service.
Example: Primary Physician, Technologist, etc.
Note
Note.ContentType
String
ReliableValueSetRequiredDescribes the type of text provided in Note.FileContents.
-
Additional values may be added by Redox in the future.
-
Note.FileContents
String
ProbableContains the content of the file. This should be a Blob URL if the file is referenced. Otherwise, this contains plain or rich text.
If using data on demand, the plain or rich text is stored as base64 encoded data. It gets decoded when responding to a Notes.Query.
Note.FileName
String
ProbableDisplays the name of the document.
Note.FileType
String
ProbableIdentifies the format of the file (e.g., PDF, JPG). Use this if referencing a file with a Redox Blob URL.
Not supported with data on demand.
Note.DocumentType
String
ReliableRequiredClassifies the type of document (e.g., consent form, treatment plan).
Note.OriginalDocumentID
String
PossibleRequiredID of the note being replaced
Note.DocumentID
String
ReliableRequiredContains the unique identifier for this document. You must have the document ID to update the document later.
This ID is required in order to update the document with Modify messages
Note.DocumentDescription
String
PossibleContains a descriptive label for the document.
Not supported with data on demand.
Note.ServiceDateTime
DateTime
ReliableDisplays the time of the clinical service that the document is related to. For example, for a surgical note, this would be the date/time of the surgery.
Note.DocumentationDateTime
DateTime
ReliableDisplays the timestamp for when the document was finalized or created. For example, a surgeon may enter the surgical note contents after the surgery. This timestamp represents the time the note was saved.
For example, a surgeon may enter the surgical note contents following the surgery. This is the field representing the time the note was saved.
Note.Status
String
ProbableValueSetTDisplays the authenticated status of the document, which can be either Authenticated or In progress. If Authenticated, the related Note.Authenticator field must be populated.
-
Additional values may be added by Redox in the future.
-
Note.Availability
String
ProbableValueSetIndicates whether the document is available for use.
-
Additional values may be added by Redox in the future.
-
Note.Provider.ID
String
ProbableRequiredID of the Provider responsible for the document
Note.Provider.IDType
String
ProbableID type of the ID for the Provider responsible for the document
Note.Provider.FirstName
String
PossibleFirst name of the Provider responsible for the document
Note.Provider.LastName
String
PossibleLast name of the Provider responsible for the document
Note.Provider.Credentials[]
Array of Strings
PossibleList of credentials for the Provider responsible for the document.
e.g. MD, PhD
Note.Provider.Address
Object
PossibleProvider's address
Note.Provider.Address.StreetAddress
String
PossibleStreet address
Note.Provider.Address.City
String
PossibleCity
Note.Provider.Address.State
String
PossibleState
Note.Provider.Address.ZIP
String
PossibleZIP
Note.Provider.Address.County
String
PossibleCounty
Note.Provider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Provider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Provider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Provider.Location
Object
PossibleProvider's location
Note.Provider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Provider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Provider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Provider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Provider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Provider.Location.Department
String
PossibleDepartment
Note.Provider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Provider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Provider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Provider.Location.Room
String
PossibleRoom.
Example: 136
Note.Authenticator.ID
String
ProbableID of the provider who authenticated the document.
This ID is often required for Inpatient Visits.
Note.Authenticator.IDType
String
ProbableID type of the ID for the provider who authenticated the document
Note.Authenticator.FirstName
String
PossibleFirst name of the provider who authenticated the document
Note.Authenticator.LastName
String
PossibleLast name of the provider who authenticated the document
Note.Authenticator.Credentials[]
Array of Strings
PossibleList of credentials for the provider who authenticated the document.
e.g. MD, PhD
Note.Authenticator.Address
Object
PossibleProvider's address
Note.Authenticator.Address.StreetAddress
String
PossibleStreet address
Note.Authenticator.Address.City
String
PossibleCity
Note.Authenticator.Address.State
String
PossibleState
Note.Authenticator.Address.ZIP
String
PossibleZIP
Note.Authenticator.Address.County
String
PossibleCounty
Note.Authenticator.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Authenticator.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Authenticator.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Authenticator.Location
Object
PossibleProvider's location
Note.Authenticator.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Authenticator.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Authenticator.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Authenticator.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Authenticator.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Authenticator.Location.Department
String
PossibleDepartment
Note.Authenticator.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Authenticator.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Authenticator.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Authenticator.Location.Room
String
PossibleRoom.
Example: 136
Note.Notifications[].ID
String
ReliableID of the provider who should be notified.
This ID is often required for Inpatient Visits.
Note.Notifications[].IDType
String
ReliableID type of the ID for the provider who should be notified
Note.Notifications[].FirstName
String
PossibleFirst name of the provider who should be notified
Note.Notifications[].LastName
String
PossibleLast name of the provider who should be notified
Note.Notifications[].Credentials[]
Array of Strings
PossibleList of credentials for the provider who should be notified.
e.g. MD, PhD
Note.Notifications[].Address
Object
PossibleProvider's address
Note.Notifications[].Address.StreetAddress
String
PossibleStreet address
Note.Notifications[].Address.City
String
PossibleCity
Note.Notifications[].Address.State
String
PossibleState
Note.Notifications[].Address.ZIP
String
PossibleZIP
Note.Notifications[].Address.County
String
PossibleCounty
Note.Notifications[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Notifications[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Notifications[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Notifications[].Location
Object
PossibleProvider's location
Note.Notifications[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Notifications[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Notifications[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Notifications[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Notifications[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Notifications[].Location.Department
String
PossibleDepartment
Note.Notifications[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Notifications[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Notifications[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Notifications[].Location.Room
String
PossibleRoom.
Example: 136
Note.Components[].ID
String
PossibleContains the identifier of the discrete note component. This could be either a report ID or document field ID.
Not supported with data on demand.
Note.Components[].Name
String
PossibleDisplays the name of the discrete note component (e.g., severity).
Not supported with data on demand.
Note.Components[].Value
String
PossibleContains the text of the note component, either in plain text or rich text.
Not supported with data on demand.
Note.Components[].Comments
String
PossibleContains any additional comments for the discrete note field.
Not supported with data on demand.
Orders
Orders[].ID
String
PossibleContains the unique identifier of the order request, which is assigned by the system that placed the order.
Not supported with data on demand.
Orders[].Name
String
PossibleDisplays the name of the order, which is assigned by the system that placed the order.
Not supported with data on demand.
{
"Meta": {
"DataModel": "Notes",
"EventType": "Replace",
"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": "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,
"Religion": null,
"MaritalStatus": "Single",
"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-05-06T06:00:58.872Z",
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null,
"Bed": null
},
"AdditionalStaff": []
},
"Note": {
"ContentType": "Base64 Encoded",
"FileContents": "<...base 64 file contents...>",
"FileName": "SamplePDF-Order Specific Note",
"FileType": null,
"DocumentType": "Empty File",
"OriginalDocumentID": "93770d83-f1f2-4a4c-a28e-065626a76ba8",
"DocumentID": "b169267c-10c9-4fe3-91ae-9ckf5703e90l",
"DocumentDescription": null,
"ServiceDateTime": "2015-05-06T06:00:58.872Z",
"DocumentationDateTime": "2015-05-06T06:00:58.872Z",
"Status": null,
"Availability": "Unavailable",
"Provider": {
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
"Authenticator": {
"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
}
},
"Notifications": [
{
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
{
"ID": "8263749385",
"IDType": "NPI",
"FirstName": "Jim",
"LastName": "Mica",
"Credentials": [
"RN"
],
"Address": {
"StreetAddress": "5235 Kennedy Ave.",
"City": "Creve Cour",
"State": "MO",
"ZIP": "63141",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+13145557777"
},
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Components": []
},
"Orders": [
{
"ID": 123456,
"Name": "Stress Test"
}
]
}
A Delete event type can be used to delete a document that was previously added to the patient's chart. The Delete event type isn't supported with data on demand.
Fields
Meta
Meta.DataModel
String
ReliableRequiredNotes
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
ReliableDisplays a unique identifier for the patient visit. We highly recommend including a visit number so the document can be associated with a specific visit.
Visit.AccountNumber
String
PossibleContains an identifier that can span several visits often related to the same patient condition (e.g., surgeries, research study, pregnancy). In other words, the account number can be used to link related visits.
Visit.PatientClass
String
ReliableClassifies the department or type of patient care. Patient class is used in many EHR systems to determine where to put the patient (e.g., inpatient, outpatient, emergency).
Visit.VisitDateTime
String
ReliableDisplays the timestamp for the patient visit or the time that the patient arrived for admission.
ISO 8601 Format
Visit.Location
Object
ProbableDisplays the location of the patient visit. This may be used to validate or to identify your application/device.
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
Visit.AdditionalStaff[]
PossibleContains information about all other staff assigned to the assist with the patient visit. Each may be scheduled individually.
Visit.AdditionalStaff[].ID
String
ProbableID of the Additional staff member.
This ID is often required for Inpatient Visits.
Visit.AdditionalStaff[].IDType
String
ProbableID type of the ID for the Additional staff member
Visit.AdditionalStaff[].FirstName
String
PossibleFirst name of the Additional staff member
Visit.AdditionalStaff[].LastName
String
PossibleLast name of the Additional staff member
Visit.AdditionalStaff[].Credentials[]
Array of Strings
PossibleList of credentials for the Additional staff member.
e.g. MD, PhD
Visit.AdditionalStaff[].Address
Object
PossibleProvider's address
Visit.AdditionalStaff[].Address.StreetAddress
String
PossibleStreet address
Visit.AdditionalStaff[].Address.City
String
PossibleCity
Visit.AdditionalStaff[].Address.State
String
PossibleState
Visit.AdditionalStaff[].Address.ZIP
String
PossibleZIP
Visit.AdditionalStaff[].Address.County
String
PossibleCounty
Visit.AdditionalStaff[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit.AdditionalStaff[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Visit.AdditionalStaff[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Visit.AdditionalStaff[].Location
Object
PossibleProvider's location
Visit.AdditionalStaff[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Visit.AdditionalStaff[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Visit.AdditionalStaff[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Visit.AdditionalStaff[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Visit.AdditionalStaff[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AdditionalStaff[].Location.Department
String
PossibleDepartment
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Visit.AdditionalStaff[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Visit.AdditionalStaff[].Location.Room
String
PossibleRoom.
Example: 136
Visit.AdditionalStaff[].Role
Object
ProbableIdentifies an additional staff member.
Visit.AdditionalStaff[].Role.Code
String
ProbableCode for the service
Visit.AdditionalStaff[].Role.Codeset
String
ProbableCode set used to identify the service.
Codeset will be blank for system-defined codes.
Visit.AdditionalStaff[].Role.Description
String
ProbableDescription of the service.
Example: Primary Physician, Technologist, etc.
Note
Note.ContentType
String
ReliableValueSetRequiredDescribes the type of text provided in Note.FileContents.
-
Additional values may be added by Redox in the future.
-
Note.FileName
String
ProbableDisplays the name of the document.
Note.FileType
String
ProbableIdentifies the format of the file (e.g., PDF, JPG). Use this if referencing a file with a Redox Blob URL.
Not supported with data on demand.
Note.DocumentType
String
ReliableRequiredClassifies the type of document (e.g., consent form, treatment plan).
Note.DocumentID
String
ReliableRequiredContains the unique identifier for this document. You must have the document ID to update the document later.
This ID is required in order to update the document with Modify messages
Note.DocumentDescription
String
PossibleContains a descriptive label for the document.
Not supported with data on demand.
Note.ServiceDateTime
DateTime
ReliableDisplays the time of the clinical service that the document is related to. For example, for a surgical note, this would be the date/time of the surgery.
Note.DocumentationDateTime
DateTime
ReliableDisplays the timestamp for when the document was finalized or created. For example, a surgeon may enter the surgical note contents after the surgery. This timestamp represents the time the note was saved.
For example, a surgeon may enter the surgical note contents following the surgery. This is the field representing the time the note was saved.
Note.Status
String
ProbableValueSetTDisplays the authenticated status of the document, which can be either Authenticated or In progress. If Authenticated, the related Note.Authenticator field must be populated.
-
Additional values may be added by Redox in the future.
-
Note.Availability
String
ProbableValueSetIndicates whether the document is available for use.
-
Additional values may be added by Redox in the future.
-
Note.Provider.ID
String
ProbableRequiredID of the Provider responsible for the document
Note.Provider.IDType
String
ProbableID type of the ID for the Provider responsible for the document
Note.Provider.FirstName
String
PossibleFirst name of the Provider responsible for the document
Note.Provider.LastName
String
PossibleLast name of the Provider responsible for the document
Note.Provider.Credentials[]
Array of Strings
PossibleList of credentials for the Provider responsible for the document.
e.g. MD, PhD
Note.Provider.Address
Object
PossibleProvider's address
Note.Provider.Address.StreetAddress
String
PossibleStreet address
Note.Provider.Address.City
String
PossibleCity
Note.Provider.Address.State
String
PossibleState
Note.Provider.Address.ZIP
String
PossibleZIP
Note.Provider.Address.County
String
PossibleCounty
Note.Provider.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Provider.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Provider.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Provider.Location
Object
PossibleProvider's location
Note.Provider.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Provider.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Provider.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Provider.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Provider.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Provider.Location.Department
String
PossibleDepartment
Note.Provider.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Provider.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Provider.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Provider.Location.Room
String
PossibleRoom.
Example: 136
Note.Authenticator.ID
String
ProbableID of the provider who authenticated the document.
This ID is often required for Inpatient Visits.
Note.Authenticator.IDType
String
ProbableID type of the ID for the provider who authenticated the document
Note.Authenticator.FirstName
String
PossibleFirst name of the provider who authenticated the document
Note.Authenticator.LastName
String
PossibleLast name of the provider who authenticated the document
Note.Authenticator.Credentials[]
Array of Strings
PossibleList of credentials for the provider who authenticated the document.
e.g. MD, PhD
Note.Authenticator.Address
Object
PossibleProvider's address
Note.Authenticator.Address.StreetAddress
String
PossibleStreet address
Note.Authenticator.Address.City
String
PossibleCity
Note.Authenticator.Address.State
String
PossibleState
Note.Authenticator.Address.ZIP
String
PossibleZIP
Note.Authenticator.Address.County
String
PossibleCounty
Note.Authenticator.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Authenticator.EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Authenticator.PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Authenticator.Location
Object
PossibleProvider's location
Note.Authenticator.Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Authenticator.Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Authenticator.Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Authenticator.Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Authenticator.Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Authenticator.Location.Department
String
PossibleDepartment
Note.Authenticator.Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Authenticator.Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Authenticator.Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Authenticator.Location.Room
String
PossibleRoom.
Example: 136
Note.Notifications[].ID
String
ReliableID of the provider who should be notified.
This ID is often required for Inpatient Visits.
Note.Notifications[].IDType
String
ReliableID type of the ID for the provider who should be notified
Note.Notifications[].FirstName
String
PossibleFirst name of the provider who should be notified
Note.Notifications[].LastName
String
PossibleLast name of the provider who should be notified
Note.Notifications[].Credentials[]
Array of Strings
PossibleList of credentials for the provider who should be notified.
e.g. MD, PhD
Note.Notifications[].Address
Object
PossibleProvider's address
Note.Notifications[].Address.StreetAddress
String
PossibleStreet address
Note.Notifications[].Address.City
String
PossibleCity
Note.Notifications[].Address.State
String
PossibleState
Note.Notifications[].Address.ZIP
String
PossibleZIP
Note.Notifications[].Address.County
String
PossibleCounty
Note.Notifications[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Note.Notifications[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Note.Notifications[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Note.Notifications[].Location
Object
PossibleProvider's location
Note.Notifications[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Note.Notifications[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Note.Notifications[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Note.Notifications[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Note.Notifications[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Notifications[].Location.Department
String
PossibleDepartment
Note.Notifications[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Note.Notifications[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Note.Notifications[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Note.Notifications[].Location.Room
String
PossibleRoom.
Example: 136
Note.Components[].ID
String
PossibleContains the identifier of the discrete note component. This could be either a report ID or document field ID.
Not supported with data on demand.
Note.Components[].Name
String
PossibleDisplays the name of the discrete note component (e.g., severity).
Not supported with data on demand.
Note.Components[].Value
String
PossibleContains the text of the note component, either in plain text or rich text.
Not supported with data on demand.
Note.Components[].Comments
String
PossibleContains any additional comments for the discrete note field.
Not supported with data on demand.
Orders
Orders[].ID
String
PossibleContains the unique identifier of the order request, which is assigned by the system that placed the order.
Not supported with data on demand.
Orders[].Name
String
PossibleDisplays the name of the order, which is assigned by the system that placed the order.
Not supported with data on demand.
{
"Meta": {
"DataModel": "Notes",
"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": "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,
"Religion": null,
"MaritalStatus": "Single",
"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-05-06T06:00:58.872Z",
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null,
"Bed": null
},
"AdditionalStaff": []
},
"Note": {
"ContentType": "Base64 Encoded",
"FileName": "SamplePDF-Order Specific Note",
"FileType": null,
"DocumentType": "Empty File",
"DocumentID": "b169267c-10c9-4fe3-91ae-9ckf5703e90l",
"DocumentDescription": null,
"ServiceDateTime": "2015-05-06T06:00:58.872Z",
"DocumentationDateTime": "2015-05-06T06:00:58.872Z",
"Status": null,
"Availability": "Unavailable",
"Provider": {
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
"Authenticator": {
"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
}
},
"Notifications": [
{
"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,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
{
"ID": "8263749385",
"IDType": "NPI",
"FirstName": "Jim",
"LastName": "Mica",
"Credentials": [
"RN"
],
"Address": {
"StreetAddress": "5235 Kennedy Ave.",
"City": "Creve Cour",
"State": "MO",
"ZIP": "63141",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": "+13145557777"
},
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Components": []
},
"Orders": [
{
"ID": 123456,
"Name": "Stress Test"
}
]
}
The Query event type can be used to search for notes based on specified filter criteria (i.e., patient, visit, or document info). Check out the QueryReponse for the expected format of a response.
Fields
Meta
Meta.DataModel
String
ReliableRequiredNotes
Meta.EventType
String
ReliableRequiredQuery
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.
Patients
Patients[]
Array of Objects
ReliableArray of patients to filter results on.
If multiple patients are provided, notes associated with any of the patients will be returned.
Patients[].Identifiers[]
Array of Objects
ReliableList of IDs and ID types that identify the patient.
If multiple identifiers are provided, only patients with all identifiers will be considered.
Patients[].Identifiers[].ID
String
ReliableID of the Patient
Patients[].Identifiers[].IDType
String
ReliableID Type for the corresponding ID of this patient (ie. MRN, EHRID)
VisitNumbers
VisitNumbers[]
Array of Objects
ReliableArray of patient visits to query on.
If multiple visits are provided, notes associated with any of the patient visits will be returned.
DocumentTypes
DocumentTypes[]
Array of Objects
ReliableArray of document types to query on.
The type of note to retrieve (E.g. Consent Form, Treatment Plan)
DocumentIDs
DocumentIDs[]
Array of Objects
ReliableArray of a document identifier to query.
{
"Meta": {
"DataModel": "Notes",
"EventType": "Query",
"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
},
"Patients": [
{
"Identifiers": [
{
"ID": "0000000001",
"IDType": "MR"
},
{
"ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
"IDType": "EHRID"
},
{
"ID": "a1d4ee8aba494ca",
"IDType": "NIST"
}
]
}
],
"VisitNumbers": [
"1234",
"5678"
],
"DocumentTypes": [
"Sample Clinical Note in PDF",
"Clinical Note"
],
"DocumentIDs": [
"b169923c-42g9-4fe3-91hg-8ckf1094e90l"
]
}
QueryResponse contains the expected format of a response to a Notes.Query. Along with the actual note content, you receive the related patient and visit info. But keep in mind that you won't receive provider info in a QueryResponse. If you want to receive provider info in conjunction with notes details, we recommend listening for new notes with the Notes.New event type instead.
Fields
Meta
Meta.DataModel
String
ReliableRequiredNotes
Meta.EventType
String
ReliableRequiredQueryResponse
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.
Notes
Notes[].Patient.Identifiers[]
Array of Objects
ReliableList of IDs and ID types that identify the patient
Notes[].Patient.Identifiers[].ID
String
ReliableID for the patient
Notes[].Patient.Identifiers[].IDType
String
ReliableType of ID.
E.g. MRN, EPI
Notes[].Visit.VisitNumber
String
ReliableVisit Number.
A VisitNumber is highly recommended so that the document can be associated with a specific visit
Notes[].ContentType
String
ReliableValueSetDescribes the type of text provided in Note.FileContents.
-
Additional values may be added by Redox in the future.
-
Notes[].FileContents
String
ProbableContains the content of the file. This should be a Blob URL if the file is referenced. Otherwise, this contains plain or rich text.
Either plain text, RTF, or a Base64 encoded string
Notes[].FileName
String
ProbableDisplays the name of the document.
Notes[].DocumentType
String
ReliableClassifies the type of document (e.g., consent form, treatment plan).
Notes[].DocumentID
String
ReliableContains the unique identifier for this document. You must have the document ID to update the document later.
This ID is required in order to update the document with Modify messages
Notes[].ServiceDateTime
DateTime
ReliableDisplays the time of the clinical service that the document is related to. For example, for a surgical note, this would be the date/time of the surgery.
Notes[].DocumentationDateTime
DateTime
ReliableDisplays the timestamp for when the document was finalized or created. For example, a surgeon may enter the surgical note contents after the surgery. This timestamp represents the time the note was saved.
For example, a surgeon may enter the surgical note contents following the surgery. This is the field representing the time the note was saved.
{
"Meta": {
"DataModel": "Notes",
"EventType": "QueryResponse",
"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
},
"Notes": [
{
"Patient": {
"Identifiers": [
{
"ID": "0000000001",
"IDType": "MR"
},
{
"ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
"IDType": "EHRID"
},
{
"ID": "a1d4ee8aba494ca",
"IDType": "NIST"
}
]
},
"Visit": {
"VisitNumber": "1234"
},
"ContentType": "Base64 Encoded",
"FileContents": "JVBERi0xLjQKCjEgMCBvYmoKPDwKIC9UeXBlIC9DYXRhbG9nCiAvUGFnZXMgMiAwIFIKPj4KZW5kb2JqCgoyIDAgb2JqCjw8CiAvVHlwZSAvUGFnZXMKIC9LaWRzIFszIDAgUl0KIC9Db3VudCAxCj4+CmVuZG9iagoKMyAwIG9iago8PAogL1R5cGUgL1BhZ2UKIC9QYXJlbnQgMiAwIFIKIC9NZWRpYUJveCBbMCAwIDM1MCAyMDBdCiAvQ29udGVudHMgNCAwIFIKIC9SZXNvdXJjZXMgPDwKICAvUHJvY1NldCA1IDAgUgogIC9Gb250IDw8CiAgIC9GMSA2IDAgUgogID4+CiA+Pgo+PgplbmRvYmoKCjQgMCBvYmoKPDwgL0xlbmd0aCA3MyA+PgpzdHJlYW0KIEJUCiAgL0YxIDI0IFRmCiAgMTAwIDEwMCBUZAogIChIZWxsbyBmcm9tIFJlZG94KSBUagogRVQKZW5kc3RyZWFtCmVuZG9iagoKNSAwIG9iagogWy9QREYgL1RleHRdCmVuZG9iagoKNiAwIG9iago8PAogL1R5cGUgL0ZvbnQKIC9TdWJ0eXBlIC9UeXBlMQogL05hbWUgL0YxCiAvQmFzZUZvbnQgL0hlbHZldGljYQogL0VuY29kaW5nIC9NYWNSb21hbkVuY29kaW5nCj4+CmVuZG9iagoKeHJlZgowIDkKMDAwMDAwMDAwMCA2NTUzNSBmCjAwMDAwMDAwMDkgMDAwMDAgbgowMDAwMDAwMDc0IDAwMDAwIG4KMDAwMDAwMDEyMCAwMDAwMCBuCjAwMDAwMDAxNzkgMDAwMDAgbgowMDAwMDAwMzY0IDAwMDAwIG4KMDAwMDAwMDQ2NiAwMDAwMCBuCjAwMDAwMDA0OTYgMDAwMDAgbgoKdHJhaWxlcgo8PAovU2l6ZSA4Ci9Sb290IDEgMCBSCj4+CnN0YXJ0eHJlZgo2MjUKJSVFT0Y=",
"FileName": "SamplePDF",
"DocumentType": "Sample Clinical Note in PDF",
"DocumentID": "e52180fb-75a2-41ea-9fcd-661a996de53f",
"ServiceDateTime": "2015-05-06T06:00:58.872Z",
"DocumentationDateTime": "2015-05-06T06:00:58.872Z"
}
]
}