This data model allows you to exchange discrete clinical data—usually as a result of an order—with an EHR system.
Results data can be written as discrete data (e.g., lab values), text (e.g., pathology report), or other complex formats (e.g., PDF, JPEG, Word) to the EHR system, depending on their respective capability. If you're writing back a file, see tips for sending files.
This data model has event types that allow you to:
- receive a notification when new results are added; or
- query for and receive result data.
Receive a notification for a new result for an order you're tracking that didn't come from the EHR system.
This is identical to Results.New except that the EHR order ID (Orders[].ID) isn't required and your system's ID for the order (Orders[].ApplicationOrderID) is required.
Request Body Schema
- Metarequired, object
- DataModelrequired, stringReliable
Results
- EventTyperequired, stringReliable
NewUnsolicited
- EventDateTimestring, nullReliable
Displays the UTC date and time that an outgoing request is delivered or an incoming request is received.
ISO 8601 Format - Testboolean, nullReliable
Indicates whether the request is a test or not.
- Sourceobject
Contains the information for the system initiating the message, including the source ID and name.
Included in messages from Redox- IDstring, nullReliable
Identifies 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 - Namestring, nullReliable
Displays the name of the system initiating the message.
- DestinationsArray of object
Contains 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.- IDstring, nullReliable
Identifies the endpoint that the request is directed to.
UUID - Namestring, nullReliable
Displays the name of the endpoint that the request is directed to.
- LogsArray of object
Contains the log identifier(s) for the request.
- IDstring, nullReliable
Identifies 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 - AttemptIDstring, nullReliable
Identifies the request log attempt value, which is useful when retries are possible.
UUID
- FacilityCodestring, nullPossible
Code 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.
- Patientrequired, object
- Identifiersrequired, Array of object
List of IDs and ID types that identify the patient
- IDrequired, stringReliable
ID for the patient
- IDTyperequired, stringReliable
Type of ID.
E.g. MRN, EPI
- Demographicsobject
- FirstNamestring, nullReliable
Patient's first name
- MiddleNamestring, nullPossible
Patient's middle name or middle initial. For patients with multiple middle names, all their middle names are included in this field.
- LastNamestring, nullReliable
Patient's last name
- DOBstring, nullReliable
Patient's date of birth.
In ISO 8601 format - SSNstring, nullProbable
Patient's social security number
- Sexstring, nullReliableValue Set
Patient's sex
- Racestring, nullPossibleValue Set
Patient's race
- IsHispanicboolean, nullPossibleValue Set
Indicates if the patient is of hispanic origin.
- Religionstring, nullPossibleValue Set
Patient's religious affiliation
- MaritalStatusstring, nullPossibleValue Set
Patient's marital status
- IsDeceasedboolean, nullPossible
Indicates if the patient is deceased
- DeathDateTimestring, nullPossible
Date and Time the patient was proclaimed deceased.
ISO 8601 Format - PhoneNumberobject
- Homestring, nullProbable
Patient's home phone number.
In E. 164 Format. (e.g. +16085551234) - Officestring, nullProbable
Patient's office phone number.
In E. 164 Format. (e.g. +16085551234) - Mobilestring, nullProbable
Patient's mobile phone number.
In E. 164 Format. (e.g. +16085551234)
- EmailAddressesArray of string
Patient's email address(es)
- Languagestring, nullPossibleValue Set
Patient's primary spoken language.
In ISO 639-1 alpha values (e.g. 'en'). Supported Values - CitizenshipArray of string
Patient's nation(s) of citizenship.
In ISO 3166 alpha 2 format (e.g. 'US'). - Addressobject
Patient's home address
- StreetAddressstring, nullProbable
Street address
- Citystring, nullProbable
City
- Statestring, nullProbable
State
- ZIPstring, nullProbable
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- NotesArray of string
Patient-level notes
- ContactsArray of object
- FirstNamestring, nullPossible
First name of the contact
- MiddleNamestring, nullPossible
Middle name of the contact
- LastNamestring, nullPossible
Last name of the contact
- Addressobject
Address of the contact
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- PhoneNumberobject
- Homestring, nullPossible
Home phone number.
In E. 164 Format. (e.g. +16085551234) - Officestring, nullPossible
Office phone number.
In E. 164 Format. (e.g. +16085551234) - Mobilestring, nullProbable
Mobile phone number.
In E. 164 Format. (e.g. +16085551234)
- RelationToPatientstring, nullPossibleValue Set
Personal relationship to the patient.
e.x. Father, Spouse - EmailAddressesArray of string
Email address(es) of the contact person
- RolesArray of string
Role of this contact for the patient.
e.x. Employer, Emergency Contact
- Ordersrequired, Array of object
- ApplicationOrderIDrequired, stringPossible
Contains the identifier of the order request, which is assigned by the system fulfilling the order.
- Statusrequired, stringReliableValue Set
Displays the current status of the order. The default value is Resulted.
Not supported with data on demand. - Resultsrequired, Array of object
Contains a list of result components and their values.
- Coderequired, stringProbable
Code for the result component
- Valuerequired, stringReliable
Displays the value of the result component. If the value type is Encapsulated Data, this field includes the base64 encoded string for the file. Learn more about sending a file.
- ValueTyperequired, stringReliableValue Set
Specifies the data type of the result value.
Not supported with data on demand. - Codesetstring, nullProbable
Code set used to identify the result component
- Descriptionstring, nullProbable
Description of the result component
Contains the identifier to group separate result components.
- Specimenobject
- Sourcestring, nullProbable
Source of the specimen
- BodySitestring, nullProbable
Body site from which the specimen was collected
- IDstring, nullPossible
ID of the collected specimen
- CompletionDateTimestring, nullPossible
Displays the timestamp for when the individual results were composed into a report and released.
- FileTypestring, nullReliable
Identifies the format of the file (e.g., PDF, JPG). If the ValueType is Encapsulated Data, this field is required.
- Unitsstring, nullProbable
Defines the units of measurement for the result.
- NotesArray of string
Includes notes about the result component/observation.
Not supported with data on demand. - AbnormalFlagstring, nullProbableValue Set
Indicates whether the result is abnormal.
- Statusstring, nullReliableValue Set
Displays the current status of the result.
- PrimaryResultsInterpreterobject
- NPIstring, nullPossible
NPI of the Primary Results Interpreter
- IDstring, nullPossible
ID of the Primary Results Interpreter.
This ID is often required for Inpatient Visits. - IDTypestring, nullPossible
ID type of the ID for the Primary Results Interpreter
- FirstNamestring, nullPossible
First name of the Primary Results Interpreter
- LastNamestring, nullPossible
Last name of the Primary Results Interpreter
- CredentialsArray of string
List of credentials for the Primary Results Interpreter.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- Producerobject
- IDstring, nullPossible
Contains the identifier of the entity that produced the result. This is typically the lab that fulfilled the order.
- Namestring, nullPossible
Displays the name of the entity (typically the lab) that produced the results.
- IDTypestring, nullPossible
Defines the type of identifier used for the corresponding ID of the entity that produced the results.
- Addressobject
Result producer's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- Performerobject
- IDstring, nullPossible
ID of the performer.
This ID is often required for Inpatient Visits. - IDTypestring, nullPossible
ID type of the ID for the performer
- FirstNamestring, nullPossible
First name of the performer
- LastNamestring, nullPossible
Last name of the performer
- CredentialsArray of string
List of credentials for the performer.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- ReferenceRangeobject
Defines the clinical range for a given result. Numeric results use low and high values to indicate a normal result. Non-numeric results populate the normal value in the text field.
- Lownumber, nullPossible
Specifies the lower bound for a normal result.
- Highnumber, nullPossible
Specifies the upper bound for a normal result.
- Textstring, nullPossible
Contains the normal value for non-numeric results.
- ObservationMethodobject
Indicates the method used to obtain the observation. This field is used when an observation may be obtained by different methods and the sending system wishes to indicate which method was used.
- Codestring, nullPossible
Code for the observation method
- Codesetstring, nullPossible
Code set used to identify the observation method
- Descriptionstring, nullPossible
Description of the observation method
- IDstring, nullReliable
Contains the unique identifier of the order request, which is assigned by the system that placed the order.
- TransactionDateTimestring, nullReliable
Displays the timestamp (in ISO 8601 format) for when the order was updated with results.
Not supported with data on demand. - CollectionDateTimestring, nullReliable
Displays the timestamp for when the specimen was collected.
ISO 8601 Format - CompletionDateTimestring, nullProbable
Date and time the results were composed into a report and released.
ISO 8601 Format - NotesArray of string
Contains any order-level notes.
Not supported with data on demand. - ResultsStatusstring, nullReliableValue Set
Specifies the current overall status of the order.
- Procedureobject
Displays the procedure associated with the results.
- Codestring, nullReliable
Code for the procedure
- Codesetstring, nullReliable
Code set used to identify the procedure.
CPT, HCPCS, SNOMED, or LOINC. If no code set is specified, a health system specific identifier is being used. - Descriptionstring, nullReliable
Description of the procedure
- Providerobject
- NPIstring, nullPossible
NPI of the ordering provider
- IDstring, nullPossible
ID of the ordering provider.
This ID is often required for Inpatient Visits. - IDTypestring, nullPossible
ID type of the ID for the ordering provider
- FirstNamestring, nullPossible
First name of the ordering provider
- LastNamestring, nullPossible
Last name of the ordering provider
- CredentialsArray of string
List of credentials for the ordering provider.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- ResultCopyProvidersArray of object
Contains the providers that should be copied on the results.
Not supported with data on demand.- IDstring, nullPossible
ID of the copied provider.
This ID is often required for Inpatient Visits. - IDTypestring, nullPossible
ID type of the ID for the copied provider
- FirstNamestring, nullPossible
First name of the copied provider
- LastNamestring, nullPossible
Last name of the copied provider
- CredentialsArray of string
List of credentials for the copied provider.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- ResponseFlagstring, nullProbable
Specifies the response type that the receiving system requests. Derived from HL7 Table 0121. The default value is D, which includes associated segments.
Not supported with data on demand. - Prioritystring, nullReliableValue Set
Indicates the priority of the order.
Not supported with data on demand.
- Visitobject
Contains information about the visit associated with the result. In many cases, this will be the visit information from the associated order.
- VisitDateTimestring, nullPossible
DateTime of visit or the arrival time of the admission.
ISO 8601 Format - VisitNumberstring, nullPossible
Visit Number.
Unique ID of a single visit - AccountNumberstring, nullPossible
Account Number.
An ID that can span several visits often related to the same issue - pregnancy, surgeries, research study, etc. - PatientClassstring, nullPossible
Patient class is used in many EHRs to determine where to put the patient.
Examples: Inpatient, Outpatient, Emergency - Locationobject
Location of the visit
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136 - Bedstring, nullPossible
Bed.
Example: B
- AttendingProviderobject
- IDstring, nullPossible
ID of the attending provider.
This ID is often required for Inpatient Visits. - IDTypestring, nullPossible
ID type of the ID for the attending provider
- FirstNamestring, nullPossible
First name of the attending provider
- LastNamestring, nullPossible
Last name of the attending provider
- CredentialsArray of string
List of credentials for the attending provider.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- ReferringProviderobject
- IDstring, nullPossible
ID of the referring provider.
This ID is often required for Inpatient Visits. - IDTypestring, nullPossible
ID type of the ID for the referring provider
- FirstNamestring, nullPossible
First name of the referring provider
- LastNamestring, nullPossible
Last name of the referring provider
- CredentialsArray of string
List of credentials for the referring provider.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- AdditionalStaffArray of object
Contains information about any other staff assigned to the assist with the patient visit. Each may be scheduled individually.
- IDstring, nullProbable
ID of the Additional staff member.
This ID is often required for Inpatient Visits. - IDTypestring, nullProbable
ID type of the ID for the Additional staff member
- FirstNamestring, nullPossible
First name of the Additional staff member
- LastNamestring, nullPossible
Last name of the Additional staff member
- CredentialsArray of string
List of credentials for the Additional staff member.
e.g. MD, PhD - Addressobject
Provider's address
- StreetAddressstring, nullPossible
Street address
- Citystring, nullPossible
City
- Statestring, nullPossible
State
- ZIPstring, nullPossible
ZIP
- Countystring, nullPossible
County
- Countrystring, nullPossibleValue Set
Country
- EmailAddressesArray of string
Provider's email address(es)
- PhoneNumberobject
- Officestring, nullPossible
Provider's office phone number.
In E. 164 Format. (e.g. +16085551234)
- Locationobject
Provider's location
- Typestring, nullPossible
Type of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone - Facilitystring, nullPossible
Facility.
Example: Community Hospital - FacilityIdentifiersArray of object
List of IDs specific to this facility
- IDstring, nullPossible
An ID specific to this facility
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Departmentstring, nullPossible
Department
- DepartmentIdentifiersArray of object
List of IDs specific to this department
- IDstring, nullPossible
An ID specific to this department
- IDTypestring, nullPossible
The source or system to which this ID pertains.
Could be an OID or a human-readable name
- Roomstring, nullPossible
Room.
Example: 136
- Roleobject
Defines the role of this person in the patient visit.
- Codestring, nullProbable
Code for the service
- Codesetstring, nullProbable
Code set used to identify the service.
Codeset will be blank for system-defined codes. - Descriptionstring, nullProbable
Description of the service.
Example: Primary Physician, Technologist, etc.