Referral
The Referral data model is used to communicate patient demographic and clinical information from a referring provider to send the patient's case to another provider. This typically differs from a consultation, where a provider may review a patient without assuming authority over the patient’s care. Referrals can be internal to an organization (e.g., from one department to another) or external between organizations.
This data model is useful to maintain the administrative aspects of a referral order. Sending a referral initiates the message, then you can use the data model to track the progress of that referral throughout the authorization process from insurance and scheduling the referral.
EHR systems with advanced referral management capabilities and robust interfacing libraries typically support the Referral data model via an HL7v2 REF interface or their own proprietary API.
Alternatively, some EHR systems may not support the Referral data model. However, since a referral can be a specific type of order when it pertains to a transfer of patient responsibility for specialty care, an EHR system may support creating a referral with the Order data model instead. Just note that you may not be able to update the referral details after it’s created. This customized type of workflow varies per EHR system. We can help you determine how to best manage referrals, whether with the Referral or Order data models.
A New message is generated when a referral is booked in the EHR.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
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.
Referral
Referral.ID
String
ReliableThe Health System ID of the referral
Referral.IDType
String
ReliableThe ID type
Referral.AlternateID
String
ReliableThe alternate ID of the referral, often used by external/3rd party systems
Referral.Type
String
ReliableValueSetThe type of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Category
String
ReliableValueSetThe category of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Priority
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Status
String
ReliableValueSetThe status of the referral
-
Additional values may be added by Redox in the future.
-
Referral.DateTime
String
ReliableThe date and time the referral is considered active.
ISO 8601 Format
Referral.ExpirationDateTime
String
ReliableThe date and time the referral expires.
ISO 8601 Format
Referral.ProcessDateTime
String
ReliableThe date and time the referral was processed.
ISO 8601 Format
Referral.Reason
String
ProbableValueSetThe reason for the referral
-
Additional values may be added by Redox in the future.
-
Referral.ProviderSpecialty
String
PossibleThe provider specialty of the referral
Referral.DepartmentSpecialty
String
PossibleThe department specialty of the referral
Referral.Notes[]
Array of Strings
PossibleReferral Notes
Referral.Authorization.Plan.ID
String
PossibleThe ID of the plan
Referral.Authorization.Plan.IDType
String
PossibleThe ID type
Referral.Authorization.Plan.Name
String
PossibleThe name of the plan
Referral.Authorization.Company.ID
String
PossibleThe ID of the payor
Referral.Authorization.Company.IDType
String
PossibleThe ID type
Referral.Authorization.Company.Name
String
PossibleThe name of the payor
Referral.Authorization.DateTime
DateTime
PossibleThe date and time the authorization is effective.
ISO 8601 Format
Referral.Authorization.ExpirationDateTime
DateTime
PossibleThe date and time the authorization expires.
ISO 8601 Format
Referral.Authorization.Number
String
PossibleThe identifier for the authorization assigned by the payor
Referral.Authorization.ReimbursementLimit
String
PossibleThe reimbursement limit for this referral
Referral.Authorization.RequestedTreatmentCount
String
PossibleThe number of treatments requested
Referral.Authorization.RequestedTreatmentUnits
String
PossibleThe units associated to the treatment count.
e.g. 'instances' or 'days'
Referral.Authorization.AuthorizedTreatmentCount
String
PossibleThe number of treatments authorized
Referral.Authorization.Notes[]
Array of Strings
PossibleNotes about the authorizations
Referral.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Referral.Diagnoses[].Code
String
ProbableCode for the diagnoses
Referral.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnoses
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].Name
String
ProbableName of the diagnoses
Referral.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnoses was documented.
ISO 8601 Format
Referral.Diagnoses[].Notes[]
Array of Strings
PossibleNotes about the diagnosis
Referral.Procedures[]
Array of Objects
ReliableOrdered procedure
Referral.Procedures[].Code
String
ReliableCode for the procedure
Referral.Procedures[].Codeset
String
ReliableCode 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.
Referral.Procedures[].Description
String
ReliableDescription of the procedure
Referral.Procedures[].Notes[]
Array of Strings
PossibleNotes about the procedure
Referral.Procedures[].Quantity
String
PossibleNumber of instances for the procedure
Referral.Procedures[].Units
String
PossibleRelated units associated to the procedure quantity
Referral.Procedures[].Modifiers[]
Array of String
PossibleAssociated procedure modifiers
Referral.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Referral.Providers[].IDType
String
PossibleID type of the ID for the provider
Referral.Providers[].FirstName
String
PossibleFirst name of the undefined
Referral.Providers[].LastName
String
PossibleLast name of the undefined
Referral.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Referral.Providers[].Address
Object
PossibleProvider's address
Referral.Providers[].Address.StreetAddress
String
PossibleStreet address
Referral.Providers[].Address.City
String
PossibleCity
Referral.Providers[].Address.State
String
PossibleState
Referral.Providers[].Address.ZIP
String
PossibleZIP
Referral.Providers[].Address.County
String
PossibleCounty
Referral.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Referral.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Referral.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Referral.Providers[].Location
Object
PossibleProvider's location
Referral.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Referral.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Referral.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Department
String
PossibleDepartment
Referral.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Room
String
PossibleRoom.
Example: 136
Referral.Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
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
Patient.Contacts[].FirstName
String
PossibleFirst name of the contact
Patient.Contacts[].MiddleName
String
PossibleMiddle name of the contact
Patient.Contacts[].LastName
String
PossibleLast name of the contact
Patient.Contacts[].Address
Object
PossibleAddress of the contact
Patient.Contacts[].Address.StreetAddress
String
PossibleStreet address
Patient.Contacts[].Address.City
String
PossibleCity
Patient.Contacts[].Address.State
String
PossibleState
Patient.Contacts[].Address.ZIP
String
PossibleZIP
Patient.Contacts[].Address.County
String
PossibleCounty
Patient.Contacts[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].PhoneNumber.Home
String
PossibleHome phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Office
String
PossibleOffice phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].RelationToPatient
String
PossibleValueSetPersonal relationship to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].EmailAddresses[]
Array of string
PossibleEmail address(es) of the contact person
Patient.Contacts[].Roles[]
Array of strings
PossibleRole of this contact for the patient.
e.x. Employer, Emergency Contact
Patient.Guarantor
Object
PossiblePerson ultimately responsible for the bill of the appointment
Patient.Guarantor.Number
String
ProbableNumber of the guarantor
Patient.Guarantor.FirstName
String
ProbableFirst name
Patient.Guarantor.MiddleName
String
PossibleMiddle name
Patient.Guarantor.LastName
String
ProbableLast name
Patient.Guarantor.SSN
String
PossibleGuarantor's social security number
Patient.Guarantor.DOB
String
PossibleGuarantor's date of birth.
In ISO 8601 format
Patient.Guarantor.Sex
String
PossibleValueSetGuarantor's sex
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Spouse.FirstName
String
ProbableSpouse's first name
Patient.Guarantor.Spouse.LastName
String
ProbableSpouse's last name
Patient.Guarantor.Address
Object
ProbableAddress of the guarantor
Patient.Guarantor.Address.StreetAddress
String
ProbableStreet address
Patient.Guarantor.Address.City
String
ProbableCity
Patient.Guarantor.Address.State
String
ProbableState
Patient.Guarantor.Address.ZIP
String
ProbableZIP
Patient.Guarantor.Address.County
String
PossibleCounty
Patient.Guarantor.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.PhoneNumber.Home
String
ProbableHome phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.PhoneNumber.Business
String
ProbableBusiness phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.EmailAddresses[]
Array of Strings
ProbableGuarantor's email address(es)
Patient.Guarantor.Type
String
ProbableType of guarantor.
E.g. institution, individual
Patient.Guarantor.RelationToPatient
String
ProbableValueSetRelation to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Employer.Name
String
ProbableEmployer's name
Patient.Guarantor.Employer.Address
Object
ProbableEmployer's address
Patient.Guarantor.Employer.Address.StreetAddress
String
ProbableStreet address
Patient.Guarantor.Employer.Address.City
String
ProbableCity
Patient.Guarantor.Employer.Address.State
String
ProbableState
Patient.Guarantor.Employer.Address.ZIP
String
ProbableZIP
Patient.Guarantor.Employer.Address.County
String
PossibleCounty
Patient.Guarantor.Employer.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Employer.PhoneNumber
String
ProbableEmployer phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[]
Array of Objects
ProbableList of insurance coverages for the patient
Patient.Insurances[].Plan.ID
String
ProbableIdentifier of insurance plan
Patient.Insurances[].Plan.IDType
String
ProbableID type of insurance plan
Patient.Insurances[].Plan.Name
String
ProbableName of insurance plan
Patient.Insurances[].Plan.Type
String
PossibleType of insurance plan
Patient.Insurances[].MemberNumber
String
PossiblePatient member number
Patient.Insurances[].Company.ID
String
ProbableID of insurance company (payor)
Patient.Insurances[].Company.IDType
String
ProbableID type of insurance company (payor)
Patient.Insurances[].Company.Name
String
ProbableName of insurance company (payor)
Patient.Insurances[].Company.Address
Object
ProbableInsurance company's address
Patient.Insurances[].Company.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Company.Address.City
String
ProbableCity
Patient.Insurances[].Company.Address.State
String
ProbableState
Patient.Insurances[].Company.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Company.Address.County
String
PossibleCounty
Patient.Insurances[].Company.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Company.PhoneNumber
String
ProbableInsurance companys phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[].GroupNumber
String
ProbableInsurance policy group number
Patient.Insurances[].GroupName
String
ProbableInsurance policy group name
Patient.Insurances[].EffectiveDate
String
ProbableEffect date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].ExpirationDate
String
ProbableExpiration date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].PolicyNumber
String
ProbableInsurance policy number
Patient.Insurances[].Priority
String
PossibleValueSetThe insurance priority sequence.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].AgreementType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].CoverageType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured
Object
PossibleIndividual who has the agreement with the insurance company for the related policy
Patient.Insurances[].Insured.Identifiers[]
Array of Objects
PossibleList of IDs and ID types that identify the insured
Patient.Insurances[].Insured.Identifiers[].ID
String
PossibleID for the insured
Patient.Insurances[].Insured.Identifiers[].IDType
String
PossibleType of ID.
E.g. MRN, EPI
Patient.Insurances[].Insured.LastName
String
PossibleLast name of the insured
Patient.Insurances[].Insured.MiddleName
String
PossibleMiddle name of the insured
Patient.Insurances[].Insured.FirstName
String
PossibleFirst name of the insured
Patient.Insurances[].Insured.SSN
String
PossibleInsured's social security number
Patient.Insurances[].Insured.Relationship
String
PossibleValueSetRelationship of the insured to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.DOB
String
PossibleDate of birth of the insured.
In YYYY-MM-DD format
Patient.Insurances[].Insured.Sex
String
PossibleValueSetSex of the insured
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.Address
Object
ProbableAddress of the insured
Patient.Insurances[].Insured.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Insured.Address.City
String
ProbableCity
Patient.Insurances[].Insured.Address.State
String
ProbableState
Patient.Insurances[].Insured.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Insured.Address.County
String
PossibleCounty
Patient.Insurances[].Insured.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit
Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
{
"Meta": {
"DataModel": "Referral",
"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
},
"Referral": {
"ID": "4356789876",
"IDType": null,
"AlternateID": "2133311",
"Type": "Medical",
"Category": "Outpatient",
"Priority": "Routine",
"Status": "Pending",
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"ProcessDateTime": null,
"Reason": "Provider Ordered",
"ProviderSpecialty": null,
"DepartmentSpecialty": null,
"Notes": [],
"Authorization": {
"Plan": {
"ID": "31572",
"IDType": null,
"Name": "HMO Deductible Plan"
},
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)"
},
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"Number": "9140860055",
"ReimbursementLimit": null,
"RequestedTreatmentCount": null,
"RequestedTreatmentUnits": null,
"AuthorizedTreatmentCount": null,
"Notes": []
},
"Diagnoses": [],
"Procedures": [
{
"Code": "400500400",
"Codeset": "CPT4",
"Description": "Anticoag Therapy Referral",
"Notes": [],
"Quantity": null,
"Units": null,
"Modifiers": []
}
],
"Providers": [
{
"ID": "4236464757",
"IDType": "NPI",
"FirstName": "John",
"LastName": "Slate",
"Credentials": [
"DO"
],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Referring Provider",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Visit": {
"VisitNumber": 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": [],
"Contacts": [
{
"FirstName": "Barbara",
"MiddleName": null,
"LastName": "Bixby",
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "US"
},
"PhoneNumber": {
"Home": "+18088675303",
"Office": "+17077543758",
"Mobile": "+19189368865"
},
"RelationToPatient": "Mother",
"EmailAddresses": [
"[email protected]"
],
"Roles": [
"Emergency Contact"
]
}
],
"Guarantor": {
"Number": "10001910",
"FirstName": "Kent",
"MiddleName": null,
"LastName": "Bixby",
"SSN": null,
"DOB": null,
"Sex": null,
"Spouse": {
"FirstName": "Barbara",
"LastName": "Bixby"
},
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "USA"
},
"PhoneNumber": {
"Home": null,
"Business": null,
"Mobile": null
},
"EmailAddresses": [],
"Type": null,
"RelationToPatient": "Father",
"Employer": {
"Name": "Accelerator Labs",
"Address": {
"StreetAddress": "1456 Old Sauk Road",
"City": "Madison",
"State": "WI",
"ZIP": "53719",
"County": "Dane",
"Country": "USA"
},
"PhoneNumber": "+18083451121"
}
},
"Insurances": [
{
"Plan": {
"ID": "31572",
"IDType": "Payor ID",
"Name": "HMO Deductible Plan",
"Type": null
},
"MemberNumber": null,
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)",
"Address": {
"StreetAddress": "PO Box 14080",
"City": "Lexington",
"State": "KY",
"ZIP": "40512-4079",
"County": "Fayette",
"Country": "US"
},
"PhoneNumber": "+18089541123"
},
"GroupNumber": "847025-024-0009",
"GroupName": "Accelerator Labs",
"EffectiveDate": "2015-01-01",
"ExpirationDate": "2020-12-31",
"PolicyNumber": "9140860055",
"Priority": null,
"AgreementType": null,
"CoverageType": null,
"Insured": {
"Identifiers": [],
"LastName": null,
"MiddleName": null,
"FirstName": null,
"SSN": null,
"Relationship": null,
"DOB": null,
"Sex": null,
"Address": {
"StreetAddress": null,
"City": null,
"State": null,
"ZIP": null,
"County": null,
"Country": null
}
}
}
]
},
"Visit": {
"VisitNumber": null
}
}
Notification that a referral has been modified.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
Meta.EventType
String
ReliableRequiredModify
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.
Referral
Referral.ID
String
ReliableThe Health System ID of the referral
Referral.IDType
String
ReliableThe ID type
Referral.AlternateID
String
ReliableThe alternate ID of the referral, often used by external/3rd party systems
Referral.Type
String
ReliableValueSetThe type of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Category
String
ReliableValueSetThe category of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Priority
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Status
String
ReliableValueSetThe status of the referral
-
Additional values may be added by Redox in the future.
-
Referral.DateTime
String
ReliableThe date and time the referral is considered active.
ISO 8601 Format
Referral.ExpirationDateTime
String
ReliableThe date and time the referral expires.
ISO 8601 Format
Referral.ProcessDateTime
String
ReliableThe date and time the referral was processed.
ISO 8601 Format
Referral.Reason
String
ProbableValueSetThe reason for the referral
-
Additional values may be added by Redox in the future.
-
Referral.ProviderSpecialty
String
PossibleThe provider specialty of the referral
Referral.DepartmentSpecialty
String
PossibleThe department specialty of the referral
Referral.Notes[]
Array of Strings
PossibleReferral Notes
Referral.Authorization.Plan.ID
String
PossibleThe ID of the plan
Referral.Authorization.Plan.IDType
String
PossibleThe ID type
Referral.Authorization.Plan.Name
String
PossibleThe name of the plan
Referral.Authorization.Company.ID
String
PossibleThe ID of the payor
Referral.Authorization.Company.IDType
String
PossibleThe ID type
Referral.Authorization.Company.Name
String
PossibleThe name of the payor
Referral.Authorization.DateTime
DateTime
PossibleThe date and time the authorization is effective.
ISO 8601 Format
Referral.Authorization.ExpirationDateTime
DateTime
PossibleThe date and time the authorization expires.
ISO 8601 Format
Referral.Authorization.Number
String
PossibleThe identifier for the authorization assigned by the payor
Referral.Authorization.ReimbursementLimit
String
PossibleThe reimbursement limit for this referral
Referral.Authorization.RequestedTreatmentCount
String
PossibleThe number of treatments requested
Referral.Authorization.RequestedTreatmentUnits
String
PossibleThe units associated to the treatment count.
e.g. 'instances' or 'days'
Referral.Authorization.AuthorizedTreatmentCount
String
PossibleThe number of treatments authorized
Referral.Authorization.Notes[]
Array of Strings
PossibleNotes about the authorizations
Referral.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Referral.Diagnoses[].Code
String
ProbableCode for the diagnoses
Referral.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnoses
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].Name
String
ProbableName of the diagnoses
Referral.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnoses was documented.
ISO 8601 Format
Referral.Diagnoses[].Notes[]
Array of Strings
PossibleNotes about the diagnosis
Referral.Procedures[]
Array of Objects
ReliableOrdered procedure
Referral.Procedures[].Code
String
ReliableCode for the procedure
Referral.Procedures[].Codeset
String
ReliableCode 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.
Referral.Procedures[].Description
String
ReliableDescription of the procedure
Referral.Procedures[].Notes[]
Array of Strings
PossibleNotes about the procedure
Referral.Procedures[].Quantity
String
PossibleNumber of instances for the procedure
Referral.Procedures[].Units
String
PossibleRelated units associated to the procedure quantity
Referral.Procedures[].Modifiers[]
Array of String
PossibleAssociated procedure modifiers
Referral.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Referral.Providers[].IDType
String
PossibleID type of the ID for the provider
Referral.Providers[].FirstName
String
PossibleFirst name of the undefined
Referral.Providers[].LastName
String
PossibleLast name of the undefined
Referral.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Referral.Providers[].Address
Object
PossibleProvider's address
Referral.Providers[].Address.StreetAddress
String
PossibleStreet address
Referral.Providers[].Address.City
String
PossibleCity
Referral.Providers[].Address.State
String
PossibleState
Referral.Providers[].Address.ZIP
String
PossibleZIP
Referral.Providers[].Address.County
String
PossibleCounty
Referral.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Referral.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Referral.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Referral.Providers[].Location
Object
PossibleProvider's location
Referral.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Referral.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Referral.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Department
String
PossibleDepartment
Referral.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Room
String
PossibleRoom.
Example: 136
Referral.Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
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
Patient.Contacts[].FirstName
String
PossibleFirst name of the contact
Patient.Contacts[].MiddleName
String
PossibleMiddle name of the contact
Patient.Contacts[].LastName
String
PossibleLast name of the contact
Patient.Contacts[].Address
Object
PossibleAddress of the contact
Patient.Contacts[].Address.StreetAddress
String
PossibleStreet address
Patient.Contacts[].Address.City
String
PossibleCity
Patient.Contacts[].Address.State
String
PossibleState
Patient.Contacts[].Address.ZIP
String
PossibleZIP
Patient.Contacts[].Address.County
String
PossibleCounty
Patient.Contacts[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].PhoneNumber.Home
String
PossibleHome phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Office
String
PossibleOffice phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].RelationToPatient
String
PossibleValueSetPersonal relationship to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].EmailAddresses[]
Array of string
PossibleEmail address(es) of the contact person
Patient.Contacts[].Roles[]
Array of strings
PossibleRole of this contact for the patient.
e.x. Employer, Emergency Contact
Patient.Guarantor
Object
PossiblePerson ultimately responsible for the bill of the appointment
Patient.Guarantor.Number
String
ProbableNumber of the guarantor
Patient.Guarantor.FirstName
String
ProbableFirst name
Patient.Guarantor.MiddleName
String
PossibleMiddle name
Patient.Guarantor.LastName
String
ProbableLast name
Patient.Guarantor.SSN
String
PossibleGuarantor's social security number
Patient.Guarantor.DOB
String
PossibleGuarantor's date of birth.
In ISO 8601 format
Patient.Guarantor.Sex
String
PossibleValueSetGuarantor's sex
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Spouse.FirstName
String
ProbableSpouse's first name
Patient.Guarantor.Spouse.LastName
String
ProbableSpouse's last name
Patient.Guarantor.Address
Object
ProbableAddress of the guarantor
Patient.Guarantor.Address.StreetAddress
String
ProbableStreet address
Patient.Guarantor.Address.City
String
ProbableCity
Patient.Guarantor.Address.State
String
ProbableState
Patient.Guarantor.Address.ZIP
String
ProbableZIP
Patient.Guarantor.Address.County
String
PossibleCounty
Patient.Guarantor.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.PhoneNumber.Home
String
ProbableHome phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.PhoneNumber.Business
String
ProbableBusiness phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.EmailAddresses[]
Array of Strings
ProbableGuarantor's email address(es)
Patient.Guarantor.Type
String
ProbableType of guarantor.
E.g. institution, individual
Patient.Guarantor.RelationToPatient
String
ProbableValueSetRelation to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Employer.Name
String
ProbableEmployer's name
Patient.Guarantor.Employer.Address
Object
ProbableEmployer's address
Patient.Guarantor.Employer.Address.StreetAddress
String
ProbableStreet address
Patient.Guarantor.Employer.Address.City
String
ProbableCity
Patient.Guarantor.Employer.Address.State
String
ProbableState
Patient.Guarantor.Employer.Address.ZIP
String
ProbableZIP
Patient.Guarantor.Employer.Address.County
String
PossibleCounty
Patient.Guarantor.Employer.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Employer.PhoneNumber
String
ProbableEmployer phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[]
Array of Objects
ProbableList of insurance coverages for the patient
Patient.Insurances[].Plan.ID
String
ProbableIdentifier of insurance plan
Patient.Insurances[].Plan.IDType
String
ProbableID type of insurance plan
Patient.Insurances[].Plan.Name
String
ProbableName of insurance plan
Patient.Insurances[].Plan.Type
String
PossibleType of insurance plan
Patient.Insurances[].MemberNumber
String
PossiblePatient member number
Patient.Insurances[].Company.ID
String
ProbableID of insurance company (payor)
Patient.Insurances[].Company.IDType
String
ProbableID type of insurance company (payor)
Patient.Insurances[].Company.Name
String
ProbableName of insurance company (payor)
Patient.Insurances[].Company.Address
Object
ProbableInsurance company's address
Patient.Insurances[].Company.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Company.Address.City
String
ProbableCity
Patient.Insurances[].Company.Address.State
String
ProbableState
Patient.Insurances[].Company.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Company.Address.County
String
PossibleCounty
Patient.Insurances[].Company.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Company.PhoneNumber
String
ProbableInsurance companys phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[].GroupNumber
String
ProbableInsurance policy group number
Patient.Insurances[].GroupName
String
ProbableInsurance policy group name
Patient.Insurances[].EffectiveDate
String
ProbableEffect date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].ExpirationDate
String
ProbableExpiration date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].PolicyNumber
String
ProbableInsurance policy number
Patient.Insurances[].Priority
String
PossibleValueSetThe insurance priority sequence.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].AgreementType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].CoverageType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured
Object
PossibleIndividual who has the agreement with the insurance company for the related policy
Patient.Insurances[].Insured.Identifiers[]
Array of Objects
PossibleList of IDs and ID types that identify the insured
Patient.Insurances[].Insured.Identifiers[].ID
String
PossibleID for the insured
Patient.Insurances[].Insured.Identifiers[].IDType
String
PossibleType of ID.
E.g. MRN, EPI
Patient.Insurances[].Insured.LastName
String
PossibleLast name of the insured
Patient.Insurances[].Insured.MiddleName
String
PossibleMiddle name of the insured
Patient.Insurances[].Insured.FirstName
String
PossibleFirst name of the insured
Patient.Insurances[].Insured.SSN
String
PossibleInsured's social security number
Patient.Insurances[].Insured.Relationship
String
PossibleValueSetRelationship of the insured to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.DOB
String
PossibleDate of birth of the insured.
In YYYY-MM-DD format
Patient.Insurances[].Insured.Sex
String
PossibleValueSetSex of the insured
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.Address
Object
ProbableAddress of the insured
Patient.Insurances[].Insured.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Insured.Address.City
String
ProbableCity
Patient.Insurances[].Insured.Address.State
String
ProbableState
Patient.Insurances[].Insured.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Insured.Address.County
String
PossibleCounty
Patient.Insurances[].Insured.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit
Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
{
"Meta": {
"DataModel": "Referral",
"EventType": "Modify",
"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
},
"Referral": {
"ID": "4356789876",
"IDType": null,
"AlternateID": "2133311",
"Type": "Medical",
"Category": "Outpatient",
"Priority": "Routine",
"Status": "Pending",
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"ProcessDateTime": null,
"Reason": "Provider Ordered",
"ProviderSpecialty": null,
"DepartmentSpecialty": null,
"Notes": [],
"Authorization": {
"Plan": {
"ID": "31572",
"IDType": null,
"Name": "HMO Deductible Plan"
},
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)"
},
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"Number": "9140860055",
"ReimbursementLimit": null,
"RequestedTreatmentCount": null,
"RequestedTreatmentUnits": null,
"AuthorizedTreatmentCount": null,
"Notes": []
},
"Diagnoses": [],
"Procedures": [
{
"Code": "400500400",
"Codeset": "CPT4",
"Description": "Anticoag Therapy Referral",
"Notes": [],
"Quantity": null,
"Units": null,
"Modifiers": []
}
],
"Providers": [
{
"ID": "4236464757",
"IDType": "NPI",
"FirstName": "John",
"LastName": "Slate",
"Credentials": [
"DO"
],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Referring Provider",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Visit": {
"VisitNumber": 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": [],
"Contacts": [
{
"FirstName": "Barbara",
"MiddleName": null,
"LastName": "Bixby",
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "US"
},
"PhoneNumber": {
"Home": "+18088675303",
"Office": "+17077543758",
"Mobile": "+19189368865"
},
"RelationToPatient": "Mother",
"EmailAddresses": [
"[email protected]"
],
"Roles": [
"Emergency Contact"
]
}
],
"Guarantor": {
"Number": "10001910",
"FirstName": "Kent",
"MiddleName": null,
"LastName": "Bixby",
"SSN": null,
"DOB": null,
"Sex": null,
"Spouse": {
"FirstName": "Barbara",
"LastName": "Bixby"
},
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "USA"
},
"PhoneNumber": {
"Home": null,
"Business": null,
"Mobile": null
},
"EmailAddresses": [],
"Type": null,
"RelationToPatient": "Father",
"Employer": {
"Name": "Accelerator Labs",
"Address": {
"StreetAddress": "1456 Old Sauk Road",
"City": "Madison",
"State": "WI",
"ZIP": "53719",
"County": "Dane",
"Country": "USA"
},
"PhoneNumber": "+18083451121"
}
},
"Insurances": [
{
"Plan": {
"ID": "31572",
"IDType": "Payor ID",
"Name": "HMO Deductible Plan",
"Type": null
},
"MemberNumber": null,
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)",
"Address": {
"StreetAddress": "PO Box 14080",
"City": "Lexington",
"State": "KY",
"ZIP": "40512-4079",
"County": "Fayette",
"Country": "US"
},
"PhoneNumber": "+18089541123"
},
"GroupNumber": "847025-024-0009",
"GroupName": "Accelerator Labs",
"EffectiveDate": "2015-01-01",
"ExpirationDate": "2020-12-31",
"PolicyNumber": "9140860055",
"Priority": null,
"AgreementType": null,
"CoverageType": null,
"Insured": {
"Identifiers": [],
"LastName": null,
"MiddleName": null,
"FirstName": null,
"SSN": null,
"Relationship": null,
"DOB": null,
"Sex": null,
"Address": {
"StreetAddress": null,
"City": null,
"State": null,
"ZIP": null,
"County": null,
"Country": null
}
}
}
]
},
"Visit": {
"VisitNumber": null
}
}
Notification that a referral has been cancelled.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
Meta.EventType
String
ReliableRequiredCancel
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.
Referral
Referral.ID
String
ReliableThe Health System ID of the referral
Referral.IDType
String
ReliableThe ID type
Referral.AlternateID
String
ReliableThe alternate ID of the referral, often used by external/3rd party systems
Referral.Type
String
ReliableValueSetThe type of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Category
String
ReliableValueSetThe category of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Priority
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Status
String
ReliableValueSetThe status of the referral
-
Additional values may be added by Redox in the future.
-
Referral.DateTime
String
ReliableThe date and time the referral is considered active.
ISO 8601 Format
Referral.ExpirationDateTime
String
ReliableThe date and time the referral expires.
ISO 8601 Format
Referral.ProcessDateTime
String
ReliableThe date and time the referral was processed.
ISO 8601 Format
Referral.Reason
String
ProbableValueSetThe reason for the referral
-
Additional values may be added by Redox in the future.
-
Referral.ProviderSpecialty
String
PossibleThe provider specialty of the referral
Referral.DepartmentSpecialty
String
PossibleThe department specialty of the referral
Referral.Notes[]
Array of Strings
PossibleReferral Notes
Referral.Authorization.Plan.ID
String
PossibleThe ID of the plan
Referral.Authorization.Plan.IDType
String
PossibleThe ID type
Referral.Authorization.Plan.Name
String
PossibleThe name of the plan
Referral.Authorization.Company.ID
String
PossibleThe ID of the payor
Referral.Authorization.Company.IDType
String
PossibleThe ID type
Referral.Authorization.Company.Name
String
PossibleThe name of the payor
Referral.Authorization.DateTime
DateTime
PossibleThe date and time the authorization is effective.
ISO 8601 Format
Referral.Authorization.ExpirationDateTime
DateTime
PossibleThe date and time the authorization expires.
ISO 8601 Format
Referral.Authorization.Number
String
PossibleThe identifier for the authorization assigned by the payor
Referral.Authorization.ReimbursementLimit
String
PossibleThe reimbursement limit for this referral
Referral.Authorization.RequestedTreatmentCount
String
PossibleThe number of treatments requested
Referral.Authorization.RequestedTreatmentUnits
String
PossibleThe units associated to the treatment count.
e.g. 'instances' or 'days'
Referral.Authorization.AuthorizedTreatmentCount
String
PossibleThe number of treatments authorized
Referral.Authorization.Notes[]
Array of Strings
PossibleNotes about the authorizations
Referral.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Referral.Diagnoses[].Code
String
ProbableCode for the diagnoses
Referral.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnoses
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].Name
String
ProbableName of the diagnoses
Referral.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnoses was documented.
ISO 8601 Format
Referral.Diagnoses[].Notes[]
Array of Strings
PossibleNotes about the diagnosis
Referral.Procedures[]
Array of Objects
ReliableOrdered procedure
Referral.Procedures[].Code
String
ReliableCode for the procedure
Referral.Procedures[].Codeset
String
ReliableCode 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.
Referral.Procedures[].Description
String
ReliableDescription of the procedure
Referral.Procedures[].Notes[]
Array of Strings
PossibleNotes about the procedure
Referral.Procedures[].Quantity
String
PossibleNumber of instances for the procedure
Referral.Procedures[].Units
String
PossibleRelated units associated to the procedure quantity
Referral.Procedures[].Modifiers[]
Array of String
PossibleAssociated procedure modifiers
Referral.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Referral.Providers[].IDType
String
PossibleID type of the ID for the provider
Referral.Providers[].FirstName
String
PossibleFirst name of the undefined
Referral.Providers[].LastName
String
PossibleLast name of the undefined
Referral.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Referral.Providers[].Address
Object
PossibleProvider's address
Referral.Providers[].Address.StreetAddress
String
PossibleStreet address
Referral.Providers[].Address.City
String
PossibleCity
Referral.Providers[].Address.State
String
PossibleState
Referral.Providers[].Address.ZIP
String
PossibleZIP
Referral.Providers[].Address.County
String
PossibleCounty
Referral.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Referral.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Referral.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Referral.Providers[].Location
Object
PossibleProvider's location
Referral.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Referral.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Referral.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Department
String
PossibleDepartment
Referral.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Room
String
PossibleRoom.
Example: 136
Referral.Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
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
Patient.Contacts[].FirstName
String
PossibleFirst name of the contact
Patient.Contacts[].MiddleName
String
PossibleMiddle name of the contact
Patient.Contacts[].LastName
String
PossibleLast name of the contact
Patient.Contacts[].Address
Object
PossibleAddress of the contact
Patient.Contacts[].Address.StreetAddress
String
PossibleStreet address
Patient.Contacts[].Address.City
String
PossibleCity
Patient.Contacts[].Address.State
String
PossibleState
Patient.Contacts[].Address.ZIP
String
PossibleZIP
Patient.Contacts[].Address.County
String
PossibleCounty
Patient.Contacts[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].PhoneNumber.Home
String
PossibleHome phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Office
String
PossibleOffice phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].RelationToPatient
String
PossibleValueSetPersonal relationship to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].EmailAddresses[]
Array of string
PossibleEmail address(es) of the contact person
Patient.Contacts[].Roles[]
Array of strings
PossibleRole of this contact for the patient.
e.x. Employer, Emergency Contact
Patient.Guarantor
Object
PossiblePerson ultimately responsible for the bill of the appointment
Patient.Guarantor.Number
String
ProbableNumber of the guarantor
Patient.Guarantor.FirstName
String
ProbableFirst name
Patient.Guarantor.MiddleName
String
PossibleMiddle name
Patient.Guarantor.LastName
String
ProbableLast name
Patient.Guarantor.SSN
String
PossibleGuarantor's social security number
Patient.Guarantor.DOB
String
PossibleGuarantor's date of birth.
In ISO 8601 format
Patient.Guarantor.Sex
String
PossibleValueSetGuarantor's sex
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Spouse.FirstName
String
ProbableSpouse's first name
Patient.Guarantor.Spouse.LastName
String
ProbableSpouse's last name
Patient.Guarantor.Address
Object
ProbableAddress of the guarantor
Patient.Guarantor.Address.StreetAddress
String
ProbableStreet address
Patient.Guarantor.Address.City
String
ProbableCity
Patient.Guarantor.Address.State
String
ProbableState
Patient.Guarantor.Address.ZIP
String
ProbableZIP
Patient.Guarantor.Address.County
String
PossibleCounty
Patient.Guarantor.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.PhoneNumber.Home
String
ProbableHome phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.PhoneNumber.Business
String
ProbableBusiness phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Guarantor.EmailAddresses[]
Array of Strings
ProbableGuarantor's email address(es)
Patient.Guarantor.Type
String
ProbableType of guarantor.
E.g. institution, individual
Patient.Guarantor.RelationToPatient
String
ProbableValueSetRelation to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Employer.Name
String
ProbableEmployer's name
Patient.Guarantor.Employer.Address
Object
ProbableEmployer's address
Patient.Guarantor.Employer.Address.StreetAddress
String
ProbableStreet address
Patient.Guarantor.Employer.Address.City
String
ProbableCity
Patient.Guarantor.Employer.Address.State
String
ProbableState
Patient.Guarantor.Employer.Address.ZIP
String
ProbableZIP
Patient.Guarantor.Employer.Address.County
String
PossibleCounty
Patient.Guarantor.Employer.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Guarantor.Employer.PhoneNumber
String
ProbableEmployer phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[]
Array of Objects
ProbableList of insurance coverages for the patient
Patient.Insurances[].Plan.ID
String
ProbableIdentifier of insurance plan
Patient.Insurances[].Plan.IDType
String
ProbableID type of insurance plan
Patient.Insurances[].Plan.Name
String
ProbableName of insurance plan
Patient.Insurances[].Plan.Type
String
PossibleType of insurance plan
Patient.Insurances[].MemberNumber
String
PossiblePatient member number
Patient.Insurances[].Company.ID
String
ProbableID of insurance company (payor)
Patient.Insurances[].Company.IDType
String
ProbableID type of insurance company (payor)
Patient.Insurances[].Company.Name
String
ProbableName of insurance company (payor)
Patient.Insurances[].Company.Address
Object
ProbableInsurance company's address
Patient.Insurances[].Company.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Company.Address.City
String
ProbableCity
Patient.Insurances[].Company.Address.State
String
ProbableState
Patient.Insurances[].Company.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Company.Address.County
String
PossibleCounty
Patient.Insurances[].Company.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Company.PhoneNumber
String
ProbableInsurance companys phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[].GroupNumber
String
ProbableInsurance policy group number
Patient.Insurances[].GroupName
String
ProbableInsurance policy group name
Patient.Insurances[].EffectiveDate
String
ProbableEffect date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].ExpirationDate
String
ProbableExpiration date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].PolicyNumber
String
ProbableInsurance policy number
Patient.Insurances[].Priority
String
PossibleValueSetThe insurance priority sequence.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].AgreementType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].CoverageType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured
Object
PossibleIndividual who has the agreement with the insurance company for the related policy
Patient.Insurances[].Insured.Identifiers[]
Array of Objects
PossibleList of IDs and ID types that identify the insured
Patient.Insurances[].Insured.Identifiers[].ID
String
PossibleID for the insured
Patient.Insurances[].Insured.Identifiers[].IDType
String
PossibleType of ID.
E.g. MRN, EPI
Patient.Insurances[].Insured.LastName
String
PossibleLast name of the insured
Patient.Insurances[].Insured.MiddleName
String
PossibleMiddle name of the insured
Patient.Insurances[].Insured.FirstName
String
PossibleFirst name of the insured
Patient.Insurances[].Insured.SSN
String
PossibleInsured's social security number
Patient.Insurances[].Insured.Relationship
String
PossibleValueSetRelationship of the insured to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.DOB
String
PossibleDate of birth of the insured.
In YYYY-MM-DD format
Patient.Insurances[].Insured.Sex
String
PossibleValueSetSex of the insured
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.Address
Object
ProbableAddress of the insured
Patient.Insurances[].Insured.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Insured.Address.City
String
ProbableCity
Patient.Insurances[].Insured.Address.State
String
ProbableState
Patient.Insurances[].Insured.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Insured.Address.County
String
PossibleCounty
Patient.Insurances[].Insured.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Visit
Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
{
"Meta": {
"DataModel": "Referral",
"EventType": "Cancel",
"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
},
"Referral": {
"ID": "4356789876",
"IDType": null,
"AlternateID": "2133311",
"Type": "Medical",
"Category": "Outpatient",
"Priority": "Routine",
"Status": "Pending",
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"ProcessDateTime": null,
"Reason": "Provider Ordered",
"ProviderSpecialty": null,
"DepartmentSpecialty": null,
"Notes": [],
"Authorization": {
"Plan": {
"ID": "31572",
"IDType": null,
"Name": "HMO Deductible Plan"
},
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)"
},
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"Number": "9140860055",
"ReimbursementLimit": null,
"RequestedTreatmentCount": null,
"RequestedTreatmentUnits": null,
"AuthorizedTreatmentCount": null,
"Notes": []
},
"Diagnoses": [],
"Procedures": [
{
"Code": "400500400",
"Codeset": "CPT4",
"Description": "Anticoag Therapy Referral",
"Notes": [],
"Quantity": null,
"Units": null,
"Modifiers": []
}
],
"Providers": [
{
"ID": "4236464757",
"IDType": "NPI",
"FirstName": "John",
"LastName": "Slate",
"Credentials": [
"DO"
],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Referring Provider",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Visit": {
"VisitNumber": 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": [],
"Contacts": [
{
"FirstName": "Barbara",
"MiddleName": null,
"LastName": "Bixby",
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "US"
},
"PhoneNumber": {
"Home": "+18088675303",
"Office": "+17077543758",
"Mobile": "+19189368865"
},
"RelationToPatient": "Mother",
"EmailAddresses": [
"[email protected]"
],
"Roles": [
"Emergency Contact"
]
}
],
"Guarantor": {
"Number": "10001910",
"FirstName": "Kent",
"MiddleName": null,
"LastName": "Bixby",
"SSN": null,
"DOB": null,
"Sex": null,
"Spouse": {
"FirstName": "Barbara",
"LastName": "Bixby"
},
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "USA"
},
"PhoneNumber": {
"Home": null,
"Business": null,
"Mobile": null
},
"EmailAddresses": [],
"Type": null,
"RelationToPatient": "Father",
"Employer": {
"Name": "Accelerator Labs",
"Address": {
"StreetAddress": "1456 Old Sauk Road",
"City": "Madison",
"State": "WI",
"ZIP": "53719",
"County": "Dane",
"Country": "USA"
},
"PhoneNumber": "+18083451121"
}
},
"Insurances": [
{
"Plan": {
"ID": "31572",
"IDType": "Payor ID",
"Name": "HMO Deductible Plan",
"Type": null
},
"MemberNumber": null,
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)",
"Address": {
"StreetAddress": "PO Box 14080",
"City": "Lexington",
"State": "KY",
"ZIP": "40512-4079",
"County": "Fayette",
"Country": "US"
},
"PhoneNumber": "+18089541123"
},
"GroupNumber": "847025-024-0009",
"GroupName": "Accelerator Labs",
"EffectiveDate": "2015-01-01",
"ExpirationDate": "2020-12-31",
"PolicyNumber": "9140860055",
"Priority": null,
"AgreementType": null,
"CoverageType": null,
"Insured": {
"Identifiers": [],
"LastName": null,
"MiddleName": null,
"FirstName": null,
"SSN": null,
"Relationship": null,
"DOB": null,
"Sex": null,
"Address": {
"StreetAddress": null,
"City": null,
"State": null,
"ZIP": null,
"County": null,
"Country": null
}
}
}
]
},
"Visit": {
"VisitNumber": null
}
}
AuthReviewlink
BETAAn Authorization Review Request is generated when a provider requests authorization for a referral from a payor or other third party. Note the Referral object is deprecated in favor of the Authorization object.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
Meta.EventType
String
ReliableRequiredAuthReview
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.
Referral
Referral.ID
String
ReliableThe Health System ID of the referral
Referral.IDType
String
ReliableThe ID type
Referral.AlternateID
String
ReliableThe alternate ID of the referral, often used by external/3rd party systems
Referral.Type
String
ReliableValueSetThe type of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Category
String
ReliableValueSetThe category of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Priority
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Status
String
ReliableValueSetThe status of the referral
-
Additional values may be added by Redox in the future.
-
Referral.DateTime
String
ReliableThe date and time the referral is considered active.
ISO 8601 Format
Referral.ExpirationDateTime
String
ReliableThe date and time the referral expires.
ISO 8601 Format
Referral.ProcessDateTime
String
ReliableThe date and time the referral was processed.
ISO 8601 Format
Referral.Reason
String
ProbableValueSetThe reason for the referral
-
Additional values may be added by Redox in the future.
-
Referral.ProviderSpecialty
String
PossibleThe provider specialty of the referral
Referral.DepartmentSpecialty
String
PossibleThe department specialty of the referral
Referral.Notes[]
Array of Strings
PossibleReferral Notes
Referral.Authorization.Plan.ID
String
PossibleThe ID of the plan
Referral.Authorization.Plan.IDType
String
PossibleThe ID type
Referral.Authorization.Plan.Name
String
PossibleThe name of the plan
Referral.Authorization.Company.ID
String
PossibleThe ID of the payor
Referral.Authorization.Company.IDType
String
PossibleThe ID type
Referral.Authorization.Company.Name
String
PossibleThe name of the payor
Referral.Authorization.DateTime
DateTime
PossibleThe date and time the authorization is effective.
ISO 8601 Format
Referral.Authorization.ExpirationDateTime
DateTime
PossibleThe date and time the authorization expires.
ISO 8601 Format
Referral.Authorization.Number
String
PossibleThe identifier for the authorization assigned by the payor
Referral.Authorization.ReimbursementLimit
String
PossibleThe reimbursement limit for this referral
Referral.Authorization.RequestedTreatmentCount
String
PossibleThe number of treatments requested
Referral.Authorization.RequestedTreatmentUnits
String
PossibleThe units associated to the treatment count.
e.g. 'instances' or 'days'
Referral.Authorization.AuthorizedTreatmentCount
String
PossibleThe number of treatments authorized
Referral.Authorization.Notes[]
Array of Strings
PossibleNotes about the authorizations
Referral.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Referral.Diagnoses[].Code
String
ProbableCode for the diagnoses
Referral.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnoses
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].Name
String
ProbableName of the diagnoses
Referral.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnoses was documented.
ISO 8601 Format
Referral.Diagnoses[].Notes[]
Array of Strings
PossibleNotes about the diagnosis
Referral.Procedures[]
Array of Objects
ReliableOrdered procedure
Referral.Procedures[].Code
String
ReliableCode for the procedure
Referral.Procedures[].Codeset
String
ReliableCode 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.
Referral.Procedures[].Description
String
ReliableDescription of the procedure
Referral.Procedures[].Notes[]
Array of Strings
PossibleNotes about the procedure
Referral.Procedures[].Quantity
String
PossibleNumber of instances for the procedure
Referral.Procedures[].Units
String
PossibleRelated units associated to the procedure quantity
Referral.Procedures[].Modifiers[]
Array of String
PossibleAssociated procedure modifiers
Referral.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Referral.Providers[].IDType
String
PossibleID type of the ID for the provider
Referral.Providers[].FirstName
String
PossibleFirst name of the undefined
Referral.Providers[].LastName
String
PossibleLast name of the undefined
Referral.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Referral.Providers[].Address
Object
PossibleProvider's address
Referral.Providers[].Address.StreetAddress
String
PossibleStreet address
Referral.Providers[].Address.City
String
PossibleCity
Referral.Providers[].Address.State
String
PossibleState
Referral.Providers[].Address.ZIP
String
PossibleZIP
Referral.Providers[].Address.County
String
PossibleCounty
Referral.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Referral.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Referral.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Referral.Providers[].Location
Object
PossibleProvider's location
Referral.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Referral.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Referral.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Department
String
PossibleDepartment
Referral.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Room
String
PossibleRoom.
Example: 136
Referral.Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
Referral.ServiceLocation
String
PossibleValueSetCode characterizing the location where the referral or service is to take place.
-
Additional values may be added by Redox in the future.
-
Referral.RequestType
String
ReliableValueSetCode indicating the type of request.
-
Additional values may be added by Redox in the future.
-
Referral.RelatedCause
String
PossibleValueSetCode indicating a related illness or injury.
-
Additional values may be added by Redox in the future.
-
Authorization
Authorization.Request.ID
String
ReliableThe requesting system's ID for the authorization review request
Authorization.Request.IDType
String
ReliableThe requesting system's ID type for the authorization review request
Authorization.AlternateID
String
PossibleThe alternate ID of the authorization review request, often used by external/3rd party systems
Authorization.Type
String
ReliableValueSetThe type of authorization request
-
Additional values may be added by Redox in the future.
-
Authorization.Category
String
ReliableValueSetThe category of authorization request
-
Additional values may be added by Redox in the future.
-
Authorization.CertificationCode
String
ReliableValueSetThe type of certification being sought by the requestor
-
Additional values may be added by Redox in the future.
-
Authorization.ServiceType
String
ReliableValueSetThe type of service associated to the authorization request
-
Additional values may be added by Redox in the future.
-
Authorization.ServiceLocation
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Authorization.RelatedCause
String
PossibleValueSetCode indicating a related illness or injury.
-
Additional values may be added by Redox in the future.
-
Authorization.ServiceLevel
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Authorization.EventDate
String
ReliableThe expected date of the requested service.
ISO 8601 Format
Authorization.Quantity.Value
String
ReliableRequested quantity
Authorization.Quantity.Units
String
ReliableAssociated units to requested quantity
Authorization.AdmissionSource
String
PossibleValueSetCode indicating the source of an inpatient admission
-
Additional values may be added by Redox in the future.
-
Authorization.AdmissionType
String
PossibleValueSetCode indicating the type of inpatient admission.
-
Additional values may be added by Redox in the future.
-
Authorization.AdditionalDates[]
Array of Objects
ProbableCollection of additional dates related to the authorization
Authorization.AdditionalDates[].DateTime
String
Probable
Authorization.AdditionalDates[].Type
String
ProbableValueSetType of date value
-
Additional values may be added by Redox in the future.
-
Authorization.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Authorization.Diagnoses[].Code
String
ProbableCode for the diagnosis
Authorization.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnosis
-
Additional values may be added by Redox in the future.
-
Authorization.Diagnoses[].Name
String
ProbableName of the diagnosis
Authorization.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Authorization.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnosis was documented.
ISO 8601 Format
Authorization.Notes[]
Array of Strings
PossibleNotes about the authorization
Authorization.Services[]
Array of Objects
ReliableServices included in the authorization review
Authorization.Services[].Code
String
ReliableCode for the service line
Authorization.Services[].Codeset
String
ReliableCode set used to identify the service line.
CPT, HCPCS, SNOMED, or LOINC. If no code set is specified, a health system specific identifier is being used.
Authorization.Services[].Description
String
ReliableDescription of the service line
Authorization.Services[].RevenueCode
String
ProbableInstitutional Revenue Code
Authorization.Services[].Quantity.Value
String
ReliableRequested service line quantity
Authorization.Services[].Quantity.Units
String
ReliableAssociated units to the requested quantity
Authorization.Services[].Modifiers[]
Array of String
PossibleService line modifiers
Authorization.Services[].ServiceDate
Date
ProbableThe date the service line is to be performed, if different than the authorization's event date.
ISO 8601 Format
Authorization.Services[].Notes[]
Array of Strings
PossibleNotes about the service line
Authorization.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Authorization.Providers[].IDType
String
PossibleID type of the ID for the provider
Authorization.Providers[].FirstName
String
PossibleFirst name of the undefined
Authorization.Providers[].LastName
String
PossibleLast name of the undefined
Authorization.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Authorization.Providers[].Address
Object
PossibleProvider's address
Authorization.Providers[].Address.StreetAddress
String
PossibleStreet address
Authorization.Providers[].Address.City
String
PossibleCity
Authorization.Providers[].Address.State
String
PossibleState
Authorization.Providers[].Address.ZIP
String
PossibleZIP
Authorization.Providers[].Address.County
String
PossibleCounty
Authorization.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Authorization.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Authorization.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Authorization.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Authorization.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Authorization.Providers[].Location
Object
PossibleProvider's location
Authorization.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Authorization.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Authorization.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Authorization.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Authorization.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Authorization.Providers[].Location.Department
String
PossibleDepartment
Authorization.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Authorization.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Authorization.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Authorization.Providers[].Location.Room
String
PossibleRoom.
Example: 136
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
Patient.Insurances[]
Array of Objects
ProbableList of insurance coverages for the patient
Patient.Insurances[].Plan.ID
String
ProbableIdentifier of insurance plan
Patient.Insurances[].Plan.IDType
String
ProbableID type of insurance plan
Patient.Insurances[].Plan.Name
String
ProbableName of insurance plan
Patient.Insurances[].Plan.Type
String
PossibleType of insurance plan
Patient.Insurances[].MemberNumber
String
PossiblePatient member number
Patient.Insurances[].Company.ID
String
ProbableID of insurance company (payor)
Patient.Insurances[].Company.IDType
String
ProbableID type of insurance company (payor)
Patient.Insurances[].Company.Name
String
ProbableName of insurance company (payor)
Patient.Insurances[].Company.Address
Object
ProbableInsurance company's address
Patient.Insurances[].Company.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Company.Address.City
String
ProbableCity
Patient.Insurances[].Company.Address.State
String
ProbableState
Patient.Insurances[].Company.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Company.Address.County
String
PossibleCounty
Patient.Insurances[].Company.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Company.PhoneNumber
String
ProbableInsurance companys phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[].GroupNumber
String
ProbableInsurance policy group number
Patient.Insurances[].GroupName
String
ProbableInsurance policy group name
Patient.Insurances[].EffectiveDate
String
ProbableEffect date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].ExpirationDate
String
ProbableExpiration date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].PolicyNumber
String
ProbableInsurance policy number
Patient.Insurances[].Priority
String
PossibleValueSetThe insurance priority sequence.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].AgreementType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].CoverageType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured
Object
PossibleIndividual who has the agreement with the insurance company for the related policy
Patient.Insurances[].Insured.Identifiers[]
Array of Objects
PossibleList of IDs and ID types that identify the insured
Patient.Insurances[].Insured.Identifiers[].ID
String
PossibleID for the insured
Patient.Insurances[].Insured.Identifiers[].IDType
String
PossibleType of ID.
E.g. MRN, EPI
Patient.Insurances[].Insured.LastName
String
PossibleLast name of the insured
Patient.Insurances[].Insured.MiddleName
String
PossibleMiddle name of the insured
Patient.Insurances[].Insured.FirstName
String
PossibleFirst name of the insured
Patient.Insurances[].Insured.SSN
String
PossibleInsured's social security number
Patient.Insurances[].Insured.Relationship
String
PossibleValueSetRelationship of the insured to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.DOB
String
PossibleDate of birth of the insured.
In YYYY-MM-DD format
Patient.Insurances[].Insured.Sex
String
PossibleValueSetSex of the insured
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.Address
Object
ProbableAddress of the insured
Patient.Insurances[].Insured.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Insured.Address.City
String
ProbableCity
Patient.Insurances[].Insured.Address.State
String
ProbableState
Patient.Insurances[].Insured.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Insured.Address.County
String
PossibleCounty
Patient.Insurances[].Insured.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
{
"Meta": {
"DataModel": "Referral",
"EventType": "AuthReview",
"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
},
"Referral": {
"ID": null,
"IDType": null,
"AlternateID": null,
"Type": null,
"Category": null,
"Priority": null,
"Status": null,
"DateTime": null,
"ExpirationDateTime": null,
"ProcessDateTime": null,
"Reason": null,
"ProviderSpecialty": null,
"DepartmentSpecialty": null,
"Notes": [],
"Authorization": {
"Plan": {
"ID": null,
"IDType": null,
"Name": null
},
"Company": {
"ID": null,
"IDType": null,
"Name": null
},
"DateTime": null,
"ExpirationDateTime": null,
"Number": null,
"ReimbursementLimit": null,
"RequestedTreatmentCount": null,
"RequestedTreatmentUnits": null,
"AuthorizedTreatmentCount": null,
"Notes": []
},
"Diagnoses": [],
"Procedures": [],
"Providers": [],
"Visit": {
"VisitNumber": null
},
"ServiceLocation": null,
"RequestType": null,
"RelatedCause": null
},
"Authorization": {
"Request": {
"ID": "4356789876",
"IDType": null
},
"AlternateID": "2133311",
"Type": "Professional",
"Category": "Procedure",
"CertificationCode": "Initial",
"ServiceType": "Medical Care",
"ServiceLocation": "On Campus - Outpatient Hospital",
"RelatedCause": null,
"ServiceLevel": null,
"EventDate": "2021-05-25",
"Quantity": {
"Value": "1",
"Units": "Visit"
},
"AdmissionSource": null,
"AdmissionType": null,
"AdditionalDates": [],
"Diagnoses": [],
"Notes": [],
"Services": [
{
"Code": "400500400",
"Codeset": "CPT4",
"Description": "Anticoag Therapy Referral",
"RevenueCode": null,
"Quantity": {
"Value": "1",
"Units": "Visit"
},
"Modifiers": [],
"ServiceDate": null,
"Notes": []
}
],
"Providers": [
{
"ID": "4236464757",
"IDType": "NPI",
"FirstName": "John",
"LastName": "Slate",
"Credentials": [
"DO"
],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Referring Provider",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
{
"ID": "4236567757",
"IDType": "NPI",
"FirstName": null,
"LastName": "East River Hospital",
"Credentials": [],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Service Facility",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": 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": [],
"Insurances": [
{
"Plan": {
"ID": "31572",
"IDType": "Payor ID",
"Name": "HMO Deductible Plan",
"Type": null
},
"MemberNumber": null,
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)",
"Address": {
"StreetAddress": "PO Box 14080",
"City": "Lexington",
"State": "KY",
"ZIP": "40512-4079",
"County": "Fayette",
"Country": "US"
},
"PhoneNumber": "+18089541123"
},
"GroupNumber": "847025-024-0009",
"GroupName": "Accelerator Labs",
"EffectiveDate": "2015-01-01",
"ExpirationDate": "2020-12-31",
"PolicyNumber": "9140860055",
"Priority": null,
"AgreementType": null,
"CoverageType": null,
"Insured": {
"Identifiers": [],
"LastName": null,
"MiddleName": null,
"FirstName": null,
"SSN": null,
"Relationship": null,
"DOB": null,
"Sex": null,
"Address": {
"StreetAddress": null,
"City": null,
"State": null,
"ZIP": null,
"County": null,
"Country": null
}
}
}
]
}
}
AuthResponselink
BETAAn Authorization Review Response is generated by a payor or other third party after reviewing an authorization request. Note the Referral object is deprecated in favor of the Authorization object.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
Meta.EventType
String
ReliableRequiredAuthResponse
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.
Referral
Referral.ID
String
ReliableThe Health System ID of the referral
Referral.IDType
String
ReliableThe ID type
Referral.AlternateID
String
ReliableThe alternate ID of the referral, often used by external/3rd party systems
Referral.Type
String
ReliableValueSetThe type of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Category
String
ReliableValueSetThe category of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Priority
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Referral.Status
String
ReliableValueSetThe status of the referral
-
Additional values may be added by Redox in the future.
-
Referral.DateTime
String
ReliableThe date and time the referral is considered active.
ISO 8601 Format
Referral.ExpirationDateTime
String
ReliableThe date and time the referral expires.
ISO 8601 Format
Referral.ProcessDateTime
String
ReliableThe date and time the referral was processed.
ISO 8601 Format
Referral.Reason
String
ProbableValueSetThe reason for the referral
-
Additional values may be added by Redox in the future.
-
Referral.ProviderSpecialty
String
PossibleThe provider specialty of the referral
Referral.DepartmentSpecialty
String
PossibleThe department specialty of the referral
Referral.Notes[]
Array of Strings
PossibleReferral Notes
Referral.Authorization.Plan.ID
String
PossibleThe ID of the plan
Referral.Authorization.Plan.IDType
String
PossibleThe ID type
Referral.Authorization.Plan.Name
String
PossibleThe name of the plan
Referral.Authorization.Company.ID
String
PossibleThe ID of the payor
Referral.Authorization.Company.IDType
String
PossibleThe ID type
Referral.Authorization.Company.Name
String
PossibleThe name of the payor
Referral.Authorization.DateTime
DateTime
PossibleThe date and time the authorization is effective.
ISO 8601 Format
Referral.Authorization.ExpirationDateTime
DateTime
PossibleThe date and time the authorization expires.
ISO 8601 Format
Referral.Authorization.Number
String
PossibleThe identifier for the authorization assigned by the payor
Referral.Authorization.ReimbursementLimit
String
PossibleThe reimbursement limit for this referral
Referral.Authorization.RequestedTreatmentCount
String
PossibleThe number of treatments requested
Referral.Authorization.RequestedTreatmentUnits
String
PossibleThe units associated to the treatment count.
e.g. 'instances' or 'days'
Referral.Authorization.AuthorizedTreatmentCount
String
PossibleThe number of treatments authorized
Referral.Authorization.Notes[]
Array of Strings
PossibleNotes about the authorizations
Referral.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Referral.Diagnoses[].Code
String
ProbableCode for the diagnoses
Referral.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnoses
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].Name
String
ProbableName of the diagnoses
Referral.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Referral.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnoses was documented.
ISO 8601 Format
Referral.Diagnoses[].Notes[]
Array of Strings
PossibleNotes about the diagnosis
Referral.Procedures[]
Array of Objects
ReliableOrdered procedure
Referral.Procedures[].Code
String
ReliableCode for the procedure
Referral.Procedures[].Codeset
String
ReliableCode 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.
Referral.Procedures[].Description
String
ReliableDescription of the procedure
Referral.Procedures[].Notes[]
Array of Strings
PossibleNotes about the procedure
Referral.Procedures[].Quantity
String
PossibleNumber of instances for the procedure
Referral.Procedures[].Units
String
PossibleRelated units associated to the procedure quantity
Referral.Procedures[].Modifiers[]
Array of String
PossibleAssociated procedure modifiers
Referral.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Referral.Providers[].IDType
String
PossibleID type of the ID for the provider
Referral.Providers[].FirstName
String
PossibleFirst name of the undefined
Referral.Providers[].LastName
String
PossibleLast name of the undefined
Referral.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Referral.Providers[].Address
Object
PossibleProvider's address
Referral.Providers[].Address.StreetAddress
String
PossibleStreet address
Referral.Providers[].Address.City
String
PossibleCity
Referral.Providers[].Address.State
String
PossibleState
Referral.Providers[].Address.ZIP
String
PossibleZIP
Referral.Providers[].Address.County
String
PossibleCounty
Referral.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Referral.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Referral.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Referral.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Referral.Providers[].Location
Object
PossibleProvider's location
Referral.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Referral.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Referral.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Referral.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Department
String
PossibleDepartment
Referral.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Referral.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referral.Providers[].Location.Room
String
PossibleRoom.
Example: 136
Referral.Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
Referral.ServiceLocation
String
PossibleValueSetCode characterizing the location where the referral or service is to take place.
-
Additional values may be added by Redox in the future.
-
Referral.RequestType
String
ReliableValueSetCode indicating the type of request.
-
Additional values may be added by Redox in the future.
-
Referral.RelatedCause
String
PossibleValueSetCode indicating a related illness or injury.
-
Additional values may be added by Redox in the future.
-
Referral.StatusReason
String
PossibleThe reason for the status of the referral.
Referral.Procedures[].Status
String
PossibleStatus of the procedure
Referral.Procedures[].StatusReason
String
PossibleReason for the procedure status
Referral.Procedures[].Authorization.DateTime
DateTime
ProbableThe date and time the authorization for this service is effective.
ISO 8601 Format
Referral.Procedures[].Authorization.ExpirationDateTime
DateTime
ProbableThe date and time the authorization for this service expires.
ISO 8601 Format
Authorization
Authorization.Request.ID
String
ReliableThe requesting system's ID for the authorization review request
Authorization.Request.IDType
String
ReliableThe requesting system's ID type for the authorization review request
Authorization.AlternateID
String
PossibleThe alternate ID of the authorization review request, often used by external/3rd party systems
Authorization.Number
String
ReliableThe authorizing system's ID
Authorization.Type
String
ReliableValueSetThe type of authorization request
-
Additional values may be added by Redox in the future.
-
Authorization.Category
String
ReliableValueSetThe category of authorization request
-
Additional values may be added by Redox in the future.
-
Authorization.CertificationCode
String
ReliableValueSetThe type of certification being sought by the requestor
-
Additional values may be added by Redox in the future.
-
Authorization.ServiceType
String
ReliableValueSetThe type of service associated to the authorization request
-
Additional values may be added by Redox in the future.
-
Authorization.ServiceLocation
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Authorization.RelatedCause
String
PossibleValueSetCode indicating a related illness or injury.
-
Additional values may be added by Redox in the future.
-
Authorization.ServiceLevel
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Authorization.EventDate
String
ReliableThe expected date of the requested service.
ISO 8601 Format
Authorization.Quantity.Value
String
ReliableApproved quantity
Authorization.Quantity.Units
String
ReliableAssociated units to approved quantity
Authorization.AdmissionSource
String
PossibleValueSetCode indicating the source of an inpatient admission
-
Additional values may be added by Redox in the future.
-
Authorization.AdmissionType
String
PossibleValueSetCode indicating the type of inpatient admission.
-
Additional values may be added by Redox in the future.
-
Authorization.AdditionalDates[]
Array of Objects
ProbableCollection of additional dates related to the authorization
Authorization.AdditionalDates[].DateTime
String
Probable
Authorization.AdditionalDates[].Type
String
ProbableValueSetType of date value
-
Additional values may be added by Redox in the future.
-
Authorization.Decision
String
ReliableValueSetAuthorization decision
-
Additional values may be added by Redox in the future.
-
Authorization.DecisionReason
String
ReliableAssociated reason for the decision
Authorization.IssueDate
Date
ProbableThe date the authorization's approval was issued.
ISO 8601 Format
Authorization.EffectiveDate
Date
ProbableThe effective date of the approved authorization.
ISO 8601 Format
Authorization.ExpirationDate
Date
ProbableThe date when the approval for the authorization expires.
ISO 8601 Format
Authorization.Diagnoses[]
Array of Objects
ProbableList of diagnoses
Authorization.Diagnoses[].Code
String
ProbableCode for the diagnosis
Authorization.Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnosis
-
Additional values may be added by Redox in the future.
-
Authorization.Diagnoses[].Name
String
ProbableName of the diagnosis
Authorization.Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Authorization.Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnosis was documented.
ISO 8601 Format
Authorization.Notes[]
Array of Strings
PossibleNotes about the authorization
Authorization.Services[]
Array of Objects
ReliableServices included in the authorization review
Authorization.Services[].Code
String
ReliableCode for the service line
Authorization.Services[].Codeset
String
ReliableCode set used to identify the service line.
CPT, HCPCS, SNOMED, or LOINC. If no code set is specified, a health system specific identifier is being used.
Authorization.Services[].Description
String
ReliableDescription of the service line
Authorization.Services[].RevenueCode
String
ProbableInstitutional Revenue Code
Authorization.Services[].Quantity.Value
String
ReliableApproved service line quantity
Authorization.Services[].Quantity.Units
String
ReliableAssociated units to the approved quantity
Authorization.Services[].Modifiers[]
Array of String
PossibleService line modifiers
Authorization.Services[].ServiceDate
Date
ProbableThe date the service line is to be performed, if different than the authorization's event date.
ISO 8601 Format
Authorization.Services[].AuthorizationNumber
String
ProbableThe identifier assigned to the service by the reviewer
Authorization.Services[].Decision
String
ReliableValueSetAuthorization service line decision
-
Additional values may be added by Redox in the future.
-
Authorization.Services[].DecisionReason
String
ReliableAssociated reason for the decision
Authorization.Services[].IssueDate
Date
ProbableThe date the service line's approval was issued, if different than the authorization's issue date.
ISO 8601 Format
Authorization.Services[].EffectiveDate
Date
ProbableThe effective date of the approved service line, if different than the authorization's effective date.
ISO 8601 Format
Authorization.Services[].ExpirationDate
Date
ProbableThe date when the approval for the service line expires, if different than the authorization's expiration date.
ISO 8601 Format
Authorization.Services[].Notes[]
Array of Strings
PossibleNotes about the service line
Authorization.Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Authorization.Providers[].IDType
String
PossibleID type of the ID for the provider
Authorization.Providers[].FirstName
String
PossibleFirst name of the undefined
Authorization.Providers[].LastName
String
PossibleLast name of the undefined
Authorization.Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Authorization.Providers[].Address
Object
PossibleProvider's address
Authorization.Providers[].Address.StreetAddress
String
PossibleStreet address
Authorization.Providers[].Address.City
String
PossibleCity
Authorization.Providers[].Address.State
String
PossibleState
Authorization.Providers[].Address.ZIP
String
PossibleZIP
Authorization.Providers[].Address.County
String
PossibleCounty
Authorization.Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Authorization.Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Authorization.Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Authorization.Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Authorization.Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Authorization.Providers[].Location
Object
PossibleProvider's location
Authorization.Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Authorization.Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Authorization.Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Authorization.Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Authorization.Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Authorization.Providers[].Location.Department
String
PossibleDepartment
Authorization.Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Authorization.Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Authorization.Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Authorization.Providers[].Location.Room
String
PossibleRoom.
Example: 136
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
Patient.Contacts[].FirstName
String
PossibleFirst name of the contact
Patient.Contacts[].MiddleName
String
PossibleMiddle name of the contact
Patient.Contacts[].LastName
String
PossibleLast name of the contact
Patient.Contacts[].Address
Object
PossibleAddress of the contact
Patient.Contacts[].Address.StreetAddress
String
PossibleStreet address
Patient.Contacts[].Address.City
String
PossibleCity
Patient.Contacts[].Address.State
String
PossibleState
Patient.Contacts[].Address.ZIP
String
PossibleZIP
Patient.Contacts[].Address.County
String
PossibleCounty
Patient.Contacts[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].PhoneNumber.Home
String
PossibleHome phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Office
String
PossibleOffice phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].PhoneNumber.Mobile
String
ProbableMobile phone number.
In E. 164 Format. (e.g. +16085551234)
Patient.Contacts[].RelationToPatient
String
PossibleValueSetPersonal relationship to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Contacts[].EmailAddresses[]
Array of string
PossibleEmail address(es) of the contact person
Patient.Contacts[].Roles[]
Array of strings
PossibleRole of this contact for the patient.
e.x. Employer, Emergency Contact
Patient.Insurances[]
Array of Objects
ProbableList of insurance coverages for the patient
Patient.Insurances[].Plan.ID
String
ProbableIdentifier of insurance plan
Patient.Insurances[].Plan.IDType
String
ProbableID type of insurance plan
Patient.Insurances[].Plan.Name
String
ProbableName of insurance plan
Patient.Insurances[].Plan.Type
String
PossibleType of insurance plan
Patient.Insurances[].MemberNumber
String
PossiblePatient member number
Patient.Insurances[].Company.ID
String
ProbableID of insurance company (payor)
Patient.Insurances[].Company.IDType
String
ProbableID type of insurance company (payor)
Patient.Insurances[].Company.Name
String
ProbableName of insurance company (payor)
Patient.Insurances[].Company.Address
Object
ProbableInsurance company's address
Patient.Insurances[].Company.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Company.Address.City
String
ProbableCity
Patient.Insurances[].Company.Address.State
String
ProbableState
Patient.Insurances[].Company.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Company.Address.County
String
PossibleCounty
Patient.Insurances[].Company.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Company.PhoneNumber
String
ProbableInsurance companys phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[].GroupNumber
String
ProbableInsurance policy group number
Patient.Insurances[].GroupName
String
ProbableInsurance policy group name
Patient.Insurances[].EffectiveDate
String
ProbableEffect date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].ExpirationDate
String
ProbableExpiration date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].PolicyNumber
String
ProbableInsurance policy number
Patient.Insurances[].Priority
String
PossibleValueSetThe insurance priority sequence.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].AgreementType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].CoverageType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured
Object
PossibleIndividual who has the agreement with the insurance company for the related policy
Patient.Insurances[].Insured.Identifiers[]
Array of Objects
PossibleList of IDs and ID types that identify the insured
Patient.Insurances[].Insured.Identifiers[].ID
String
PossibleID for the insured
Patient.Insurances[].Insured.Identifiers[].IDType
String
PossibleType of ID.
E.g. MRN, EPI
Patient.Insurances[].Insured.LastName
String
PossibleLast name of the insured
Patient.Insurances[].Insured.MiddleName
String
PossibleMiddle name of the insured
Patient.Insurances[].Insured.FirstName
String
PossibleFirst name of the insured
Patient.Insurances[].Insured.SSN
String
PossibleInsured's social security number
Patient.Insurances[].Insured.Relationship
String
PossibleValueSetRelationship of the insured to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.DOB
String
PossibleDate of birth of the insured.
In YYYY-MM-DD format
Patient.Insurances[].Insured.Sex
String
PossibleValueSetSex of the insured
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.Address
Object
ProbableAddress of the insured
Patient.Insurances[].Insured.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Insured.Address.City
String
ProbableCity
Patient.Insurances[].Insured.Address.State
String
ProbableState
Patient.Insurances[].Insured.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Insured.Address.County
String
PossibleCounty
Patient.Insurances[].Insured.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
{
"Meta": {
"DataModel": "Referral",
"EventType": "AuthResponse",
"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
},
"Referral": {
"ID": null,
"IDType": null,
"AlternateID": null,
"Type": null,
"Category": null,
"Priority": null,
"Status": null,
"DateTime": null,
"ExpirationDateTime": null,
"ProcessDateTime": null,
"Reason": null,
"ProviderSpecialty": null,
"DepartmentSpecialty": null,
"Notes": [],
"Authorization": {
"Plan": {
"ID": null,
"IDType": null,
"Name": null
},
"Company": {
"ID": null,
"IDType": null,
"Name": null
},
"DateTime": null,
"ExpirationDateTime": null,
"Number": null,
"ReimbursementLimit": null,
"RequestedTreatmentCount": null,
"RequestedTreatmentUnits": null,
"AuthorizedTreatmentCount": null,
"Notes": []
},
"Diagnoses": [],
"Procedures": [],
"Providers": [],
"Visit": {
"VisitNumber": null
},
"ServiceLocation": null,
"RequestType": null,
"RelatedCause": null,
"StatusReason": null
},
"Authorization": {
"Request": {
"ID": "4356789876",
"IDType": null
},
"AlternateID": "2133311",
"Number": "AB448876",
"Type": "Professional",
"Category": "Procedure",
"CertificationCode": "Initial",
"ServiceType": "Medical Care",
"ServiceLocation": "On Campus - Outpatient Hospital",
"RelatedCause": null,
"ServiceLevel": null,
"EventDate": "2021-05-25",
"Quantity": {
"Value": "1",
"Units": "Visit"
},
"AdmissionSource": null,
"AdmissionType": null,
"AdditionalDates": [],
"Decision": "Certified",
"DecisionReason": null,
"IssueDate": null,
"EffectiveDate": "2021-05-01",
"ExpirationDate": "2021-07-01",
"Diagnoses": [],
"Notes": [],
"Services": [
{
"Code": "400500400",
"Codeset": "CPT4",
"Description": "Anticoag Therapy Referral",
"RevenueCode": null,
"Quantity": {
"Value": "1",
"Units": "Visit"
},
"Modifiers": [],
"ServiceDate": null,
"AuthorizationNumber": "VVS12345",
"Decision": "Certified",
"DecisionReason": null,
"IssueDate": null,
"EffectiveDate": "2021-05-01",
"ExpirationDate": "2021-07-01",
"Notes": []
}
],
"Providers": [
{
"ID": "4236464757",
"IDType": "NPI",
"FirstName": "John",
"LastName": "Slate",
"Credentials": [
"DO"
],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Referring Provider",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
},
{
"ID": "4236567757",
"IDType": "NPI",
"FirstName": null,
"LastName": "East River Hospital",
"Credentials": [],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Service Facility",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": 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": [],
"Contacts": [
{
"FirstName": "Barbara",
"MiddleName": null,
"LastName": "Bixby",
"Address": {
"StreetAddress": "4762 Hickory Street",
"City": "Monroe",
"State": "WI",
"ZIP": "53566",
"County": "Green",
"Country": "US"
},
"PhoneNumber": {
"Home": "+18088675303",
"Office": "+17077543758",
"Mobile": "+19189368865"
},
"RelationToPatient": "Mother",
"EmailAddresses": [
"[email protected]"
],
"Roles": [
"Emergency Contact"
]
}
],
"Insurances": [
{
"Plan": {
"ID": "31572",
"IDType": "Payor ID",
"Name": "HMO Deductible Plan",
"Type": null
},
"MemberNumber": null,
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)",
"Address": {
"StreetAddress": "PO Box 14080",
"City": "Lexington",
"State": "KY",
"ZIP": "40512-4079",
"County": "Fayette",
"Country": "US"
},
"PhoneNumber": "+18089541123"
},
"GroupNumber": "847025-024-0009",
"GroupName": "Accelerator Labs",
"EffectiveDate": "2015-01-01",
"ExpirationDate": "2020-12-31",
"PolicyNumber": "9140860055",
"Priority": null,
"AgreementType": null,
"CoverageType": null,
"Insured": {
"Identifiers": [],
"LastName": null,
"MiddleName": null,
"FirstName": null,
"SSN": null,
"Relationship": null,
"DOB": null,
"Sex": null,
"Address": {
"StreetAddress": null,
"City": null,
"State": null,
"ZIP": null,
"County": null,
"Country": null
}
}
}
]
}
}
Querylink
BETAThe Referral Query will use a subset of patient demographic and insurance information to find matching referral records.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
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.
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.Insurances[]
Array of Objects
ProbableList of insurance coverages for the patient
Patient.Insurances[].Plan.ID
String
ProbableIdentifier of insurance plan
Patient.Insurances[].Plan.IDType
String
ProbableID type of insurance plan
Patient.Insurances[].Plan.Name
String
ProbableName of insurance plan
Patient.Insurances[].Plan.Type
String
PossibleType of insurance plan
Patient.Insurances[].MemberNumber
String
PossiblePatient member number
Patient.Insurances[].Company.ID
String
ProbableID of insurance company (payor)
Patient.Insurances[].Company.IDType
String
ProbableID type of insurance company (payor)
Patient.Insurances[].Company.Name
String
ProbableName of insurance company (payor)
Patient.Insurances[].Company.Address
Object
ProbableInsurance company's address
Patient.Insurances[].Company.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Company.Address.City
String
ProbableCity
Patient.Insurances[].Company.Address.State
String
ProbableState
Patient.Insurances[].Company.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Company.Address.County
String
PossibleCounty
Patient.Insurances[].Company.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Company.PhoneNumber
String
ProbableInsurance companys phone number.
In E. 164 Format (i.e. +16085551234)
Patient.Insurances[].GroupNumber
String
ProbableInsurance policy group number
Patient.Insurances[].GroupName
String
ProbableInsurance policy group name
Patient.Insurances[].EffectiveDate
String
ProbableEffect date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].ExpirationDate
String
ProbableExpiration date of this insurance policy.
In YYYY-MM-DD format
Patient.Insurances[].PolicyNumber
String
ProbableInsurance policy number
Patient.Insurances[].Priority
String
PossibleValueSetThe insurance priority sequence.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].AgreementType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].CoverageType
String
ProbableValueSetType of insurance agreement.
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured
Object
PossibleIndividual who has the agreement with the insurance company for the related policy
Patient.Insurances[].Insured.Identifiers[]
Array of Objects
PossibleList of IDs and ID types that identify the insured
Patient.Insurances[].Insured.Identifiers[].ID
String
PossibleID for the insured
Patient.Insurances[].Insured.Identifiers[].IDType
String
PossibleType of ID.
E.g. MRN, EPI
Patient.Insurances[].Insured.LastName
String
PossibleLast name of the insured
Patient.Insurances[].Insured.MiddleName
String
PossibleMiddle name of the insured
Patient.Insurances[].Insured.FirstName
String
PossibleFirst name of the insured
Patient.Insurances[].Insured.SSN
String
PossibleInsured's social security number
Patient.Insurances[].Insured.Relationship
String
PossibleValueSetRelationship of the insured to the patient
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.DOB
String
PossibleDate of birth of the insured.
In YYYY-MM-DD format
Patient.Insurances[].Insured.Sex
String
PossibleValueSetSex of the insured
-
Additional values may be added by Redox in the future.
-
Patient.Insurances[].Insured.Address
Object
ProbableAddress of the insured
Patient.Insurances[].Insured.Address.StreetAddress
String
ProbableStreet address
Patient.Insurances[].Insured.Address.City
String
ProbableCity
Patient.Insurances[].Insured.Address.State
String
ProbableState
Patient.Insurances[].Insured.Address.ZIP
String
ProbableZIP
Patient.Insurances[].Insured.Address.County
String
PossibleCounty
Patient.Insurances[].Insured.Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
{
"Meta": {
"DataModel": "Referral",
"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
},
"Patient": {
"Identifiers": [
{
"ID": "0000000001",
"IDType": "MR"
},
{
"ID": "e167267c-16c9-4fe3-96ae-9cff5703e90a",
"IDType": "EHRID"
},
{
"ID": "a1d4ee8aba494ca",
"IDType": "NIST"
}
],
"Insurances": [
{
"Plan": {
"ID": "31572",
"IDType": "Payor ID",
"Name": "HMO Deductible Plan",
"Type": null
},
"MemberNumber": null,
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)",
"Address": {
"StreetAddress": "PO Box 14080",
"City": "Lexington",
"State": "KY",
"ZIP": "40512-4079",
"County": "Fayette",
"Country": "US"
},
"PhoneNumber": "+18089541123"
},
"GroupNumber": "847025-024-0009",
"GroupName": "Accelerator Labs",
"EffectiveDate": "2015-01-01",
"ExpirationDate": "2020-12-31",
"PolicyNumber": "9140860055",
"Priority": null,
"AgreementType": null,
"CoverageType": null,
"Insured": {
"Identifiers": [],
"LastName": null,
"MiddleName": null,
"FirstName": null,
"SSN": null,
"Relationship": null,
"DOB": null,
"Sex": null,
"Address": {
"StreetAddress": null,
"City": null,
"State": null,
"ZIP": null,
"County": null,
"Country": null
}
}
}
]
}
}
This is the response to the Referral Query. If the queried system successfully matches any existing referral based on the fields provided, the query will return available fields in the Referrals array.
Fields
Meta
Meta.DataModel
String
ReliableRequiredReferral
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.
Referrals
Referrals[]
Array of Objects
ReliableThe list of referrals
Referrals[].ID
String
ReliableThe Health System ID of the referral
Referrals[].IDType
String
ReliableThe ID type
Referrals[].AlternateID
String
ReliableThe alternate ID of the referral, often used by external/3rd party systems
Referrals[].Type
String
ReliableValueSetThe type of the referral
-
Additional values may be added by Redox in the future.
-
Referrals[].Category
String
ReliableValueSetThe category of the referral
-
Additional values may be added by Redox in the future.
-
Referrals[].Priority
String
ReliableValueSetThe priority of the referral
-
Additional values may be added by Redox in the future.
-
Referrals[].Status
String
ReliableValueSetThe status of the referral
-
Additional values may be added by Redox in the future.
-
Referrals[].DateTime
String
ReliableThe date and time the referral is considered active.
ISO 8601 Format
Referrals[].ExpirationDateTime
String
ReliableThe date and time the referral expires.
ISO 8601 Format
Referrals[].ProcessDateTime
String
ReliableThe date and time the referral was processed.
ISO 8601 Format
Referrals[].Reason
String
ProbableValueSetThe reason for the referral
-
Additional values may be added by Redox in the future.
-
Referrals[].ProviderSpecialty
String
PossibleThe provider specialty of the referral
Referrals[].DepartmentSpecialty
String
PossibleThe department specialty of the referral
Referrals[].Notes[]
Array of Strings
PossibleReferral Notes
Referrals[].Authorization.Plan.ID
String
PossibleThe ID of the plan
Referrals[].Authorization.Plan.IDType
String
PossibleThe ID type
Referrals[].Authorization.Plan.Name
String
PossibleThe name of the plan
Referrals[].Authorization.Company.ID
String
PossibleThe ID of the payor
Referrals[].Authorization.Company.IDType
String
PossibleThe ID type
Referrals[].Authorization.Company.Name
String
PossibleThe name of the payor
Referrals[].Authorization.DateTime
DateTime
PossibleThe date and time the authorization is effective.
ISO 8601 Format
Referrals[].Authorization.ExpirationDateTime
DateTime
PossibleThe date and time the authorization expires.
ISO 8601 Format
Referrals[].Authorization.Number
String
PossibleThe identifier for the authorization assigned by the payor
Referrals[].Authorization.ReimbursementLimit
String
PossibleThe reimbursement limit for this referral
Referrals[].Authorization.RequestedTreatmentCount
String
PossibleThe number of treatments requested
Referrals[].Authorization.RequestedTreatmentUnits
String
PossibleThe units associated to the treatment count.
e.g. 'instances' or 'days'
Referrals[].Authorization.AuthorizedTreatmentCount
String
PossibleThe number of treatments authorized
Referrals[].Authorization.Notes[]
Array of Strings
PossibleNotes about the authorizations
Referrals[].Diagnoses[]
Array of Objects
ProbableList of diagnoses
Referrals[].Diagnoses[].Code
String
ProbableCode for the diagnoses
Referrals[].Diagnoses[].Codeset
String
ProbableValueSetCode set used to identify the diagnoses
-
Additional values may be added by Redox in the future.
-
Referrals[].Diagnoses[].Name
String
ProbableName of the diagnoses
Referrals[].Diagnoses[].Type
String
PossibleValueSetType of the diagnosis
-
Additional values may be added by Redox in the future.
-
Referrals[].Diagnoses[].DocumentedDateTime
String
PossibleDateTime the diagnoses was documented.
ISO 8601 Format
Referrals[].Diagnoses[].Notes[]
Array of Strings
PossibleNotes about the diagnosis
Referrals[].Procedures[]
Array of Objects
ReliableOrdered procedure
Referrals[].Procedures[].Code
String
ReliableCode for the procedure
Referrals[].Procedures[].Codeset
String
ReliableCode 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.
Referrals[].Procedures[].Description
String
ReliableDescription of the procedure
Referrals[].Procedures[].Notes[]
Array of Strings
PossibleNotes about the procedure
Referrals[].Procedures[].Quantity
String
PossibleNumber of instances for the procedure
Referrals[].Procedures[].Units
String
PossibleRelated units associated to the procedure quantity
Referrals[].Procedures[].Modifiers[]
Array of String
PossibleAssociated procedure modifiers
Referrals[].Providers[].ID
String
PossibleID of the provider.
This ID is often required for Inpatient Visits.
Referrals[].Providers[].IDType
String
PossibleID type of the ID for the provider
Referrals[].Providers[].FirstName
String
PossibleFirst name of the undefined
Referrals[].Providers[].LastName
String
PossibleLast name of the undefined
Referrals[].Providers[].Credentials[]
Array of Strings
PossibleList of credentials for the undefined.
e.g. MD, PhD
Referrals[].Providers[].Address
Object
PossibleProvider's address
Referrals[].Providers[].Address.StreetAddress
String
PossibleStreet address
Referrals[].Providers[].Address.City
String
PossibleCity
Referrals[].Providers[].Address.State
String
PossibleState
Referrals[].Providers[].Address.ZIP
String
PossibleZIP
Referrals[].Providers[].Address.County
String
PossibleCounty
Referrals[].Providers[].Address.Country
String
PossibleValueSetCountry
-
Additional values may be added by Redox in the future.
-
Referrals[].Providers[].EmailAddresses[]
Array of Strings
ProbableProvider's email address(es)
Referrals[].Providers[].PhoneNumber.Office
String
PossibleProvider's office phone number.
In E. 164 Format. (e.g. +16085551234)
Referrals[].Providers[].Type
String
PossibleValueSetThe type of provider
-
Additional values may be added by Redox in the future.
-
Referrals[].Providers[].ContactInfo
String
PossibleAdditional contact information for this provider
Referrals[].Providers[].Location
Object
PossibleProvider's location
Referrals[].Providers[].Location.Type
String
PossibleType of location.
Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone
Referrals[].Providers[].Location.Facility
String
PossibleFacility.
Example: Community Hospital
Referrals[].Providers[].Location.FacilityIdentifiers[]
Array of Objects
PossibleList of IDs specific to this facility
Referrals[].Providers[].Location.FacilityIdentifiers[].ID
String
PossibleAn ID specific to this facility
Referrals[].Providers[].Location.FacilityIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referrals[].Providers[].Location.Department
String
PossibleDepartment
Referrals[].Providers[].Location.DepartmentIdentifiers[]
Array of Objects
PossibleList of IDs specific to this department
Referrals[].Providers[].Location.DepartmentIdentifiers[].ID
String
PossibleAn ID specific to this department
Referrals[].Providers[].Location.DepartmentIdentifiers[].IDType
String
PossibleThe source or system to which this ID pertains.
Could be an OID or a human-readable name
Referrals[].Providers[].Location.Room
String
PossibleRoom.
Example: 136
Referrals[].Visit.VisitNumber
String
PossibleVisit Number.
Unique ID of the visit associated to the referral
{
"Meta": {
"DataModel": "Referral",
"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
},
"Referrals": [
{
"ID": "4356789876",
"IDType": null,
"AlternateID": "2133311",
"Type": "Medical",
"Category": "Outpatient",
"Priority": "Routine",
"Status": "Pending",
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"ProcessDateTime": null,
"Reason": "Provider Ordered",
"ProviderSpecialty": null,
"DepartmentSpecialty": null,
"Notes": [],
"Authorization": {
"Plan": {
"ID": "31572",
"IDType": null,
"Name": "HMO Deductible Plan"
},
"Company": {
"ID": "60054",
"IDType": null,
"Name": "aetna (60054 0131)"
},
"DateTime": "2015-05-05T00:00:00.000Z",
"ExpirationDateTime": "2015-06-05T00:00:00.000Z",
"Number": "9140860055",
"ReimbursementLimit": null,
"RequestedTreatmentCount": null,
"RequestedTreatmentUnits": null,
"AuthorizedTreatmentCount": null,
"Notes": []
},
"Diagnoses": [],
"Procedures": [
{
"Code": "400500400",
"Codeset": "CPT4",
"Description": "Anticoag Therapy Referral",
"Notes": [],
"Quantity": null,
"Units": null,
"Modifiers": []
}
],
"Providers": [
{
"ID": "4236464757",
"IDType": "NPI",
"FirstName": "John",
"LastName": "Slate",
"Credentials": [
"DO"
],
"Address": {
"StreetAddress": "500 First St.",
"City": "Clayton",
"State": "MO",
"ZIP": "63105",
"County": "Saint Louis",
"Country": "USA"
},
"EmailAddresses": [],
"PhoneNumber": {
"Office": null
},
"Type": "Referring Provider",
"ContactInfo": null,
"Location": {
"Type": null,
"Facility": null,
"FacilityIdentifiers": [],
"Department": null,
"DepartmentIdentifiers": [],
"Room": null
}
}
],
"Visit": {
"VisitNumber": null
}
}
]
}