# Clinical Decisions Request

This data model communicates real-time, immediate clinical decision support (CDS). Providers rely on the `Request` event type while vendors respond with the `Response` event type to complete the CDS workflow. 

A <u>clinical decision</u> is useful when a provider wants to recommend alternative medications/procedures or identify drug interactions before placing an order.

This data model has event types that allow you to:

- request information from a third-party app offering CDS data; and
- return clinical insights, observations, and recommendations. 

> **EHR support**
>
> The EHR system must have a corresponding CDS API that can map to the `ClinicalDecisions` data model. This typically works with Epic EHR systems, but since we built `ClinicalDecisions` on FHIR or CDS Hook specifications, it's possible for other EHR systems to support, too. 

> **ClinicalDecisions vs. SSO data model**
>
> `ClinicalDecisions` returns discrete data to offer CDS within the EHR system. It’s part of a typical ordering workflow.
>
> `SSO` is triggered when the user clicks a specially-configured button to launch an app within the EHR system. It returns a URL for the EHR system to launch the app's system.

Initiate the CDS workflow by providing the required information to the third-party vendor offering clinical insights. 

This event type contains the general format to provide CDS data, but it varies depending on use case and the EHR system's alert setup. 

For example, an alternative medications alert might be configured to fire when a provider attempts to sign an order, or an alert regarding a possible chronic condition might fire based on a patient's vitals history when a new set is documented. 

Status: Beta

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Meta` | object | Yes |  |
| `Meta.DataModel` | string | Yes | Clinical Decisions |
| `Meta.EventType` | string | Yes | Request |
| `Meta.EventDateTime` | string or null | No | Displays the UTC date and time that an outgoing request is delivered or an incoming request is received. *[ISO 8601 Format](http://en.wikipedia.org/wiki/ISO_8601)* |
| `Meta.Test` | boolean or null | No | Indicates whether the request is a test or not. |
| `Meta.Source` | object | No | Contains the information for the system initiating the message, including the source ID and name. *Included in messages from Redox* |
| `Meta.Source.ID` | string or null | No | Identifies the system initiating the message. If you have multiple OAuth API keys per environment type, this value is required. If you have only one OAuth API key per environment type, or you're using legacy API keys, this value is optional. *UUID* |
| `Meta.Source.Name` | string or null | No | Displays the name of the system initiating the message. |
| `Meta.Destinations` | Array of object | No | Contains the information for the endpoint(s) receiving the request. A request must contain at least one destination, but asynchronous requests can have more than one destination. Synchronous requests like queries can only support one destination. *Required when sending data to Redox.* |
| `Meta.Destinations[].ID` | string or null | No | Identifies the endpoint that the request is directed to. *UUID* |
| `Meta.Destinations[].Name` | string or null | No | Displays the name of the endpoint that the request is directed to. |
| `Meta.Logs` | Array of object | No | Contains the log identifier(s) for the request. |
| `Meta.Logs[].ID` | string or null | No | Identifies the request log(s) that correspond to this request. You can use this value to locate the relevant log in the Redox dashboard for support and reference. *UUID* |
| `Meta.Logs[].AttemptID` | string or null | No | Identifies the request log attempt value, which is useful when retries are possible. *UUID* |
| `Meta.FacilityCode` | string or null | No | Code for the facility related to the message. *Only use this field if a health system indicates you should. The code is specific to the health system's EHR and might not be unique across health systems. In general, the facility fields within the data models (e.g. OrderingFacility) are more reliable and informative.* |
| `Patient` | object | Yes |  |
| `Patient.Identifiers` | Array of object | Yes | List of IDs and ID types that identify the patient |
| `Patient.Identifiers[].ID` | string | Yes | ID for the patient |
| `Patient.Identifiers[].IDType` | string | Yes | Type of ID. *E.g. MRN, EPI* |
| `Patient.Demographics` | object | No |  |
| `Patient.Demographics.FirstName` | string or null | No | Patient's first name |
| `Patient.Demographics.MiddleName` | string or null | No | Patient'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 or null | No | Patient's last name |
| `Patient.Demographics.DOB` | string or null | No | Patient's date of birth. *In [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)* |
| `Patient.Demographics.SSN` | string or null | No | Patient's social security number |
| `Patient.Demographics.Sex` | string or null | No | Patient's sex. Value set ca03256a-4fd3-4b3d-8e37-912cd22b5cda: Female, Male, Unknown, Other, Nonbinary, Prefer not to answer |
| `Patient.Demographics.Race` | string or null | No | Patient's race. Value set 2d9b5abe-e939-4c55-b8e5-a2816ecb08eb: American Indian or Alaska Native, Asian, Black or African American, Native Hawaiian or Other Pacific Islander, Other Race, White, Unknown, Prefer not to answer |
| `Patient.Demographics.IsHispanic` | boolean or null | No | Indicates if the patient is of hispanic origin. Value set 731a7062-165a-434c-bef7-b02b824dfc7b: true, false, null |
| `Patient.Demographics.Religion` | string or null | No | Patient's religious affiliation. Value set 11a5dd99-3549-484c-ba0a-1b22723e9a45: Latter Day Saints, Lutheran, Mahayana, Meditation, Messianic Judaism, Mitraism, New Age, non-Roman Catholic, Occult, Adventist, African Religions, Afro-Caribbean Religions, Agnosticism, Anglican, Animism, Atheism, Babi & Baha'I faiths, Baptist, Bon, Cao Dai, Celticism, Christian, Confucianism, Cyberculture Religions, Divination, Fourth Way, Free Daism, Gnosis, Hinduism, Humanism, Independent, Islam, Jainism, Jehovah's Witnesses, Judaism, Orthodox, Paganism, Pentecostal, Reformed/Presbyterian, Roman Catholic Church, Satanism, Scientology, Shamanism, Shiite (Islam), Shinto, Sikism, Spiritualism, Sunni (Islam), Taoism, Theravada, Unitarian-Universalism, Universal Life Church, Vajrayana (Tibetan), Veda, Voodoo, Wicca, Yaohushua, Zen Buddhism, Zoroastrianism, Assembly of God, Brethren, Christian Scientist, Church of Christ, Church of God, Congregational, Disciples of Christ, Eastern Orthodox, Episcopalian, Evangelical Covenant, Friends, Full Gospel, Methodist, Native American, Nazarene, Presbyterian, Protestant, Reformed, Salvation Army, Unitarian Universalist, United Church of Christ, Protestant - No Denomination, The Process, None, Other, Unknown |
| `Patient.Demographics.MaritalStatus` | string or null | No | Patient's marital status. Value set f3f48779-ee0c-4477-b458-d8cba9303039: Separated, Unmarried, Common law, Divorced, Legally Separated, Living together, Interlocutory, Married, Annulled, Other, Domestic partner, Registered domestic partner, Single, Unreported, Unknown, Widowed, Polygamous, Never Married |
| `Patient.Demographics.IsDeceased` | boolean or null | No | Indicates if the patient is deceased |
| `Patient.Demographics.DeathDateTime` | string or null | No | Date and Time the patient was proclaimed deceased. *[ISO 8601 Format](https://en.wikipedia.org/wiki/ISO_8601)* |
| `Patient.Demographics.PhoneNumber` | object | No |  |
| `Patient.Demographics.PhoneNumber.Home` | string or null | No | Patient's home phone number. *In E. 164 Format. (e.g. +16085551234)* |
| `Patient.Demographics.PhoneNumber.Office` | string or null | No | Patient's office phone number. *In E. 164 Format. (e.g. +16085551234)* |
| `Patient.Demographics.PhoneNumber.Mobile` | string or null | No | Patient's mobile phone number. *In E. 164 Format. (e.g. +16085551234)* |
| `Patient.Demographics.EmailAddresses` | Array of string | No | Patient's email address(es) |
| `Patient.Demographics.Language` | string or null | No | Patient's primary spoken language. *In ISO 639-1 alpha values (e.g. 'en'). [Supported Values](http://www.loc.gov/standards/iso639-2/php/code_list.php)* Value set 7eeaad13-6761-41f0-ab43-5be92809afc2: af, ae, ak, bg, bh, ca, ce, ch, co, cr, cs, cu, cv, da, dz, ee, en, eo, et, eu, ff, gl, ha, hr, ii, is, lu, kk, kn, ku, kv, kw, mk, ms, nb, nd, pi, sk, om, qu, sn, sq, su, ta, ti, tk, uk, wo, yo, id, ig, jv, kj, km, ln, lo, mr, mt, na, ng, no, oj, pt, rm, rw, sg, st, sw, th, tr, tt, ur, vo, zh, aa, de, fi, ht, hy, ie, ik, ki, kl, ko, kr, ks, ky, lv, mg, mi, ml, my, ne, nl, ny, oc, os, pa, pl, ps, rn, sc, sd, si, sl, so, sr, sv, tg, tl, tn, to, tw, ty, ug, ve, vi, wa, za, es, fa, gn, hu, hz, ia, la, lt, mh, mn, nn, nr, nv, or, ro, sa, se, ss, te, ts, uz, xh, yi, zu, Other, Unknown, ab, av, ba, sgn, am, an, ay, ar, as, az, be, bi, bm, bn, bo, br, bs, cy, dv, el, fj, fo, fr, fy, ga, gd, gu, gv, he, hi, ho, io, it, iu, ja, ka, kg, lb, lg, li, ru, sm |
| `Patient.Demographics.Citizenship` | Array of string | No | Patient's nation(s) of citizenship. *In ISO 3166 alpha 2 format (e.g. 'US').* Value set 232b1e77-fd16-4f4c-838f-0d288c119806: American Samoa, Anguilla, Austria, Bahamas, Barbados, Bhutan, Bosnia and Herzegovina, Afghanistan, Åland Islands, Albania, Angola, Andorra, Argentina, Armenia, Bangladesh, Belgium, Benin, Bonaire Sint Eustatius and Saba, Botswana, Bouvet Island, British Indian Ocean Territory, Brunei Darussalam, Burkina Faso, Bulgaria, Algeria, Antarctica, Antigua and Barbuda, Aruba, Australia, Azerbaijan, Bahrain, Belarus, Belize, Bermuda, Bolivia (Plurinational State of), Brazil, Burundi, Cayman Islands, China, Colombia, Cook Islands, Curaçao, El Salvador, Cambodia, Christmas Island, Congo (the Democratic Republic of the), Croatia, Czechia, Dominica, Cabo Verde, Chad, Cocos (Keeling) Islands, Costa Rica, Denmark, Dominican Republic, Cameroon, Chile, Congo, Cyprus, Ecuador, Canada, Central African Republic, Comoros, Cuba, Djibouti, Egypt, Equatorial Guinea, Eritrea, Estonia, Ethiopia, Falkland Islands[Malvinas], Faroe Islands, Fiji, Finland, France, French Guiana, French Polynesia, French Southern Territories, Gabon, Gambia, Georgia, Germany, Ghana, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guernsey, Guinea, Guinea-Bissau, Guyana, Haiti, Heard Island and McDonald Islands, Holy See, Honduras, Hong Kong, Hungary, Iceland, India, Indonesia, Iran (Islamic Republic of), Iraq, Ireland, Isle of Man, Israel, Italy, Jamaica, Japan, Jersey, Jordan, Kazakhstan, Kenya, Kiribati, Korea (the Republic of), Kuwait, Kyrgyzstan, Liechtenstein, Madagascar, Mali, Mauritius, Monaco, Mozambique, Netherlands, Niger, Lao Peoples Democratic Republic, Latvia, Lesotho, Macao, Malta, Mayotte, Moldova (the Republic of), Myanmar, Nigeria, Oman, Lebanon, Lithuania, Malawi, Maldives, Mauritania, Mongolia, Morocco, Nepal, Nicaragua, Northern Mariana Islands, Liberia, Luxembourg, Malaysia, Martinique, Micronesia (Federated States of), Montserrat, Nauru, New Zealand, Norfolk Island, Libya, Macedonia (the former Yugoslav Republic of), Marshall Islands, Mexico, Montenegro, Namibia, New Caledonia, Niue, Norway, Pakistan, Palau, Palestine State of, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn, Poland, Portugal, Qatar, Puerto Rico, Réunion, Romania, Russian Federation, Rwanda, Saint Barthélemy, Saint Helena Ascension and Tristan da Cunha, Saint Kitts and Nevis, Saint Lucia, Saint Martin (French part), Saint Pierre and Miquelon, Saint Vincent and the Grenadines, Samoa, San Marino, Sao Tome and Principe, Saudi Arabia, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Sint Maarten (Dutch part), Slovakia, Slovenia, Solomon Islands, Somalia, South Africa, South Georgia and the South Sandwich Islands, South Sudan, Spain, Sri Lanka, Sudan, Suriname, Svalbard and Jan Mayen, Swaziland, Sweden, Switzerland, Syrian Arab Republic, Tajikistan, Taiwan (Province of China), Timor-Leste, Trinidad and Tobago, Tuvalu, Uruguay, Virgin Islands (U.S.), Yemen, Tanzania United Republic of, Turkey, Ukraine, United States of America, Viet Nam, Western Sahara*, Thailand, Tonga, Turks and Caicos Islands, United States Minor Outlying Islands, Venezuela (Bolivarian Republic of), Zimbabwe, Togo, Tunisia, Uganda, United Arab Emirates, Uzbekistan, Virgin Islands (British), Zambia, Tokelau, Turkmenistan, United Kingdom of Great Britain and Northern Ireland, Vanuatu, Wallis and Futuna, Côte dIvoire, Korea (the Democratic Peoples Republic of), Unknown |
| `Patient.Demographics.Address` | object | No | Patient's home address |
| `Patient.Demographics.Address.StreetAddress` | string or null | No | Street address |
| `Patient.Demographics.Address.City` | string or null | No | City |
| `Patient.Demographics.Address.State` | string or null | No | State |
| `Patient.Demographics.Address.ZIP` | string or null | No | ZIP |
| `Patient.Demographics.Address.County` | string or null | No | County |
| `Patient.Demographics.Address.Country` | string or null | No | Country. Value set 39791e31-0cee-4c58-a6c1-3d9e2c71d13b: AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, IO, CM, CL, CO, CI, DK, EC, ER, FK, TF, GM, GI, GW, VA, IS, IM, JP, KI, LS, LT, MK, MV, MX, MS, NA, NC, MP, PK, PG, PL, RU, PM, SA, SG, SB, SS, SE, TZ, TO, TV, US, VN, EH, ZW, BQ, BR, BF, CA, TD, KM, CK, CU, DO, EE, FI, GE, GL, GN, GY, IN, IE, JE, KW, LB, LY, MO, ML, MR, MN, MM, NZ, NU, OM, PY, PT, RO, KN, SN, RS, ZA, LK, SJ, SY, TK, TM, UG, UM, UZ, WF, BA, BG, CV, CX, CD, CW, DJ, GQ, FO, PF, DE, GD, GG, HT, HK, IR, IL, KE, KG, LU, MY, MT, MU, ME, MZ, NP, NF, PW, PH, QA, BL, MF, ST, SX, SI, GS, SR, TJ, TG, TN, UA, VU, VG, BW, BN, KH, KY, CC, CR, CY, EG, FJ, FR, GH, GP, GU, HN, IQ, JM, KZ, KP, LA, LR, MW, MH, YT, MD, MA, NI, NG, NO, PA, PN, RE, RW, LC, SM, SC, SK, ES, CH, TH, TT, TR, GB, VE, VI, ZM, BV, BI, CF, CN, CG, HR, CZ, DM, SV, ET, GF, GA, GR, GT, HM, HU, ID, IT, JO, KR, LV, LI, MG, MQ, FM, MC, NR, NL, NE, PS, PE, PR, SH, VC, WS, SL, SO, SD, SZ, TW, TL, TC, AE, UY, YE, DR |
| `Patient.Notes` | Array of string | No | Patient-level notes |
| `UnsignedMedicationOrders` | Array of object | Yes | Array of unsigned medication orders |
| `UnsignedMedicationOrders[].Identifiers` | Array of object | Yes | Array of identifiers for the medication order |
| `UnsignedMedicationOrders[].Identifiers[].ID` | string | Yes | ID of the medication order |
| `UnsignedMedicationOrders[].Identifiers[].IDType` | string | Yes | IDType of the medication order |
| `UnsignedMedicationOrders[].Frequency` | object | No |  |
| `UnsignedMedicationOrders[].Frequency.Period` | string or null | No | How often the patient should be taking the medication. *[UCUM Units of Measure](http://unitsofmeasure.org/ucum.html)* |
| `UnsignedMedicationOrders[].Frequency.Unit` | string or null | No | Units for how often the patient should be taking the medication |
| `UnsignedMedicationOrders[].Product` | object | No | The actual medication given |
| `UnsignedMedicationOrders[].Product.Code` | string or null | No | Code |
| `UnsignedMedicationOrders[].Product.Codeset` | string or null | No | Code set |
| `UnsignedMedicationOrders[].Product.Name` | string or null | No | Name |
| `UnsignedMedicationOrders[].Priority` | string or null | No | Priority for taking this medication |
| `UnsignedMedicationOrders[].Dose` | object | No |  |
| `UnsignedMedicationOrders[].Dose.Quantity` | number or null | No | The size of the dose for pills, capsules, etc. |
| `UnsignedMedicationOrders[].Dose.Units` | string or null | No | The units of the dose. *[UCUM Units of Measure](http://unitsofmeasure.org/ucum.html)* |
| `UnsignedMedicationOrders[].Mode` | string or null | No | Mode in which the medication order was created. *IP/OP* |
| `UnsignedMedicationOrders[].Route` | null or null | No | The method by which the medication is delivered. *[Medication Route FDA Value Set](https://phinvads.cdc.gov/vads/ViewValueSet.action?oid=2.16.840.1.113883.3.88.12.3221.8.7)* |
| `UnsignedMedicationOrders[].StartDate` | string or null | No | When the medication was started. *[ISO 8601 Format](http://en.wikipedia.org/wiki/ISO_8601)* |
| `UnsignedMedicationOrders[].EndDate` | string or null | No | When the medication was ended. *[ISO 8601 Format](http://en.wikipedia.org/wiki/ISO_8601)* |
| `UnsignedMedicationOrders[].MixtureType` | string or null | No | Type of mixture of the medication. *SimpleMed / IMSMixture / GenericMixture* |
| `UnsignedMedicationOrders[].MixtureComponents` | Array of object | No | The individual components of a mixed medication |
| `UnsignedMedicationOrders[].MixtureComponents[].Code` | string or null | No | The code that identifies the component. *RxNorm code* |
| `UnsignedMedicationOrders[].MixtureComponents[].CodeType` | string or null | No | Type of code sent in the code field. *RxNorm* |
| `UnsignedMedicationOrders[].MixtureComponents[].Dose` | object | No |  |
| `UnsignedMedicationOrders[].MixtureComponents[].Dose.Quantity` | string or null | No | Amount of this component added to the mixture |
| `UnsignedMedicationOrders[].MixtureComponents[].Dose.Units` | string or null | No | Units of the component added to the mixture. *[UCUM Units of Measure](http://unitsofmeasure.org/ucum.html)* |
| `UnsignedMedicationOrders[].Questions` | Array of object | No | Order-level questions |
| `UnsignedMedicationOrders[].Questions[].Question` | object | No | Information about the question |
| `UnsignedMedicationOrders[].Questions[].Question.Code` | string or null | No | Code for the question |
| `UnsignedMedicationOrders[].Questions[].Question.Codeset` | string or null | No | Code set used to identify the question |
| `UnsignedMedicationOrders[].Questions[].Question.Description` | string or null | No | Description of the question |
| `UnsignedMedicationOrders[].Questions[].Answer` | object | No | Information about the answer |
| `UnsignedMedicationOrders[].Questions[].Answer.Code` | string or null | No | Code for the answer |
| `UnsignedMedicationOrders[].Questions[].Answer.Codeset` | string or null | No | Code set used to identify the answer |
| `UnsignedMedicationOrders[].Questions[].Answer.Description` | string or null | No | Description of the answer |
| `UnsignedMedicationOrders[].Notes` | Array of string | No | Order-level notes |
| `UnsignedProcedureOrders` | Array of object | Yes | Array of unsigned procedure orders |
| `UnsignedProcedureOrders[].Identifiers` | Array of object | Yes | Array of identifiers for the procedure order |
| `UnsignedProcedureOrders[].Identifiers[].ID` | string | Yes | ID of the procedure order |
| `UnsignedProcedureOrders[].Identifiers[].IDType` | number | Yes | IDType of the procedure order |
| `UnsignedProcedureOrders[].Code` | string or null | No | Code for the procedure |
| `UnsignedProcedureOrders[].Codeset` | string or null | No | Code set used to identify the procedure |
| `UnsignedProcedureOrders[].Description` | string or null | No | Description of the procedure |
| `UnsignedProcedureOrders[].ScheduledDate` | string or null | No | Scheduled date of the procedure |
| `UnsignedProcedureOrders[].Mode` | string or null | No | Mode in which the procedure order was created. *IP/OP* |
| `UnsignedProcedureOrders[].BodySite` | object | No | The location on the body where the procedure was performed |
| `UnsignedProcedureOrders[].BodySite.Code` | string or null | No | Code |
| `UnsignedProcedureOrders[].BodySite.Codeset` | string or null | No | Code set |
| `UnsignedProcedureOrders[].BodySite.Description` | string or null | No | Description |
| `UnsignedProcedureOrders[].StartDate` | string or null | No | When the procedure was started. *[ISO 8601 Format](http://en.wikipedia.org/wiki/ISO_8601)* |
| `UnsignedProcedureOrders[].EndDate` | string or null | No | When the procedure ended. *[ISO 8601 Format](http://en.wikipedia.org/wiki/ISO_8601)* |
| `UnsignedProcedureOrders[].Questions` | Array of object | No | Order-level questions |
| `UnsignedProcedureOrders[].Questions[].Question` | object | No | Information about the question |
| `UnsignedProcedureOrders[].Questions[].Question.Code` | string or null | No | Code for the question |
| `UnsignedProcedureOrders[].Questions[].Question.Codeset` | string or null | No | Code set used to identify the question |
| `UnsignedProcedureOrders[].Questions[].Question.Description` | string or null | No | Description of the question |
| `UnsignedProcedureOrders[].Questions[].Answer` | object | No | Information about the answer |
| `UnsignedProcedureOrders[].Questions[].Answer.Code` | string or null | No | Code for the answer |
| `UnsignedProcedureOrders[].Questions[].Answer.Codeset` | string or null | No | Code set used to identify the answer |
| `UnsignedProcedureOrders[].Questions[].Answer.Description` | string or null | No | Description of the answer |
| `UnsignedProcedureOrders[].Notes` | Array of string | No | Order-level notes |
| `Session` | object | No |  |
| `Session.Questions` | Array of object | No | Questions answered by the ordering provider that apply to all of the orders in the CDS request. |
| `Session.Questions[].Question` | object | No | Information about the question |
| `Session.Questions[].Question.Code` | string or null | No | Code for the question |
| `Session.Questions[].Question.Codeset` | string or null | No | Code set used to identify the question |
| `Session.Questions[].Question.Description` | string or null | No | Description of the question |
| `Session.Questions[].Answer` | object | No | Information about the answer |
| `Session.Questions[].Answer.Code` | string or null | No | Code for the answer |
| `Session.Questions[].Answer.Codeset` | string or null | No | Code set used to identify the answer |
| `Session.Questions[].Answer.Description` | string or null | No | Description of the answer |
| `OrderingProvider` | object | No |  |
| `OrderingProvider.ID` | string or null | No | ID of the ordering provider. *This ID is often required for Inpatient Visits.* |
| `OrderingProvider.IDType` | string or null | No | ID type of the ID for the ordering provider |
| `OrderingProvider.FirstName` | string or null | No | First name of the ordering provider |
| `OrderingProvider.LastName` | string or null | No | Last name of the ordering provider |
| `OrderingProvider.Credentials` | Array of string | No | List of credentials for the ordering provider. *e.g. MD, PhD* |
| `OrderingProvider.Address` | object | No | Provider's address |
| `OrderingProvider.Address.StreetAddress` | string or null | No | Street address |
| `OrderingProvider.Address.City` | string or null | No | City |
| `OrderingProvider.Address.State` | string or null | No | State |
| `OrderingProvider.Address.ZIP` | string or null | No | ZIP |
| `OrderingProvider.Address.County` | string or null | No | County |
| `OrderingProvider.Address.Country` | string or null | No | Country. Value set 39791e31-0cee-4c58-a6c1-3d9e2c71d13b: AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, IO, CM, CL, CO, CI, DK, EC, ER, FK, TF, GM, GI, GW, VA, IS, IM, JP, KI, LS, LT, MK, MV, MX, MS, NA, NC, MP, PK, PG, PL, RU, PM, SA, SG, SB, SS, SE, TZ, TO, TV, US, VN, EH, ZW, BQ, BR, BF, CA, TD, KM, CK, CU, DO, EE, FI, GE, GL, GN, GY, IN, IE, JE, KW, LB, LY, MO, ML, MR, MN, MM, NZ, NU, OM, PY, PT, RO, KN, SN, RS, ZA, LK, SJ, SY, TK, TM, UG, UM, UZ, WF, BA, BG, CV, CX, CD, CW, DJ, GQ, FO, PF, DE, GD, GG, HT, HK, IR, IL, KE, KG, LU, MY, MT, MU, ME, MZ, NP, NF, PW, PH, QA, BL, MF, ST, SX, SI, GS, SR, TJ, TG, TN, UA, VU, VG, BW, BN, KH, KY, CC, CR, CY, EG, FJ, FR, GH, GP, GU, HN, IQ, JM, KZ, KP, LA, LR, MW, MH, YT, MD, MA, NI, NG, NO, PA, PN, RE, RW, LC, SM, SC, SK, ES, CH, TH, TT, TR, GB, VE, VI, ZM, BV, BI, CF, CN, CG, HR, CZ, DM, SV, ET, GF, GA, GR, GT, HM, HU, ID, IT, JO, KR, LV, LI, MG, MQ, FM, MC, NR, NL, NE, PS, PE, PR, SH, VC, WS, SL, SO, SD, SZ, TW, TL, TC, AE, UY, YE, DR |
| `OrderingProvider.EmailAddresses` | Array of string | No | Provider's email address(es) |
| `OrderingProvider.PhoneNumber` | object | No |  |
| `OrderingProvider.PhoneNumber.Office` | string or null | No | Provider's office phone number. *In E. 164 Format. (e.g. +16085551234)* |
| `OrderingProvider.Location` | object | No | Provider's location |
| `OrderingProvider.Location.Type` | string or null | No | Type of location. *Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone* |
| `OrderingProvider.Location.Facility` | string or null | No | Facility. *Example: Community Hospital* |
| `OrderingProvider.Location.FacilityIdentifiers` | Array of object | No | List of IDs specific to this facility |
| `OrderingProvider.Location.FacilityIdentifiers[].ID` | string or null | No | An ID specific to this facility |
| `OrderingProvider.Location.FacilityIdentifiers[].IDType` | string or null | No | The source or system to which this ID pertains. *Could be an OID or a human-readable name* |
| `OrderingProvider.Location.Department` | string or null | No | Department |
| `OrderingProvider.Location.DepartmentIdentifiers` | Array of object | No | List of IDs specific to this department |
| `OrderingProvider.Location.DepartmentIdentifiers[].ID` | string or null | No | An ID specific to this department |
| `OrderingProvider.Location.DepartmentIdentifiers[].IDType` | string or null | No | The source or system to which this ID pertains. *Could be an OID or a human-readable name* |
| `OrderingProvider.Location.Room` | string or null | No | Room. *Example: 136* |
| `AuthorizingProvider` | object | No |  |
| `AuthorizingProvider.ID` | string or null | No | ID of the authorizing provider. *This ID is often required for Inpatient Visits.* |
| `AuthorizingProvider.IDType` | string or null | No | ID type of the ID for the authorizing provider |
| `AuthorizingProvider.FirstName` | string or null | No | First name of the authorizing provider |
| `AuthorizingProvider.LastName` | string or null | No | Last name of the authorizing provider |
| `AuthorizingProvider.Credentials` | Array of string | No | List of credentials for the authorizing provider. *e.g. MD, PhD* |
| `AuthorizingProvider.Address` | object | No | Provider's address |
| `AuthorizingProvider.Address.StreetAddress` | string or null | No | Street address |
| `AuthorizingProvider.Address.City` | string or null | No | City |
| `AuthorizingProvider.Address.State` | string or null | No | State |
| `AuthorizingProvider.Address.ZIP` | string or null | No | ZIP |
| `AuthorizingProvider.Address.County` | string or null | No | County |
| `AuthorizingProvider.Address.Country` | string or null | No | Country. Value set 39791e31-0cee-4c58-a6c1-3d9e2c71d13b: AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, IO, CM, CL, CO, CI, DK, EC, ER, FK, TF, GM, GI, GW, VA, IS, IM, JP, KI, LS, LT, MK, MV, MX, MS, NA, NC, MP, PK, PG, PL, RU, PM, SA, SG, SB, SS, SE, TZ, TO, TV, US, VN, EH, ZW, BQ, BR, BF, CA, TD, KM, CK, CU, DO, EE, FI, GE, GL, GN, GY, IN, IE, JE, KW, LB, LY, MO, ML, MR, MN, MM, NZ, NU, OM, PY, PT, RO, KN, SN, RS, ZA, LK, SJ, SY, TK, TM, UG, UM, UZ, WF, BA, BG, CV, CX, CD, CW, DJ, GQ, FO, PF, DE, GD, GG, HT, HK, IR, IL, KE, KG, LU, MY, MT, MU, ME, MZ, NP, NF, PW, PH, QA, BL, MF, ST, SX, SI, GS, SR, TJ, TG, TN, UA, VU, VG, BW, BN, KH, KY, CC, CR, CY, EG, FJ, FR, GH, GP, GU, HN, IQ, JM, KZ, KP, LA, LR, MW, MH, YT, MD, MA, NI, NG, NO, PA, PN, RE, RW, LC, SM, SC, SK, ES, CH, TH, TT, TR, GB, VE, VI, ZM, BV, BI, CF, CN, CG, HR, CZ, DM, SV, ET, GF, GA, GR, GT, HM, HU, ID, IT, JO, KR, LV, LI, MG, MQ, FM, MC, NR, NL, NE, PS, PE, PR, SH, VC, WS, SL, SO, SD, SZ, TW, TL, TC, AE, UY, YE, DR |
| `AuthorizingProvider.EmailAddresses` | Array of string | No | Provider's email address(es) |
| `AuthorizingProvider.PhoneNumber` | object | No |  |
| `AuthorizingProvider.PhoneNumber.Office` | string or null | No | Provider's office phone number. *In E. 164 Format. (e.g. +16085551234)* |
| `AuthorizingProvider.Location` | object | No | Provider's location |
| `AuthorizingProvider.Location.Type` | string or null | No | Type of location. *Examples: Clinic, Department, Home, Nursing Unit, Provider's Office, Phone* |
| `AuthorizingProvider.Location.Facility` | string or null | No | Facility. *Example: Community Hospital* |
| `AuthorizingProvider.Location.FacilityIdentifiers` | Array of object | No | List of IDs specific to this facility |
| `AuthorizingProvider.Location.FacilityIdentifiers[].ID` | string or null | No | An ID specific to this facility |
| `AuthorizingProvider.Location.FacilityIdentifiers[].IDType` | string or null | No | The source or system to which this ID pertains. *Could be an OID or a human-readable name* |
| `AuthorizingProvider.Location.Department` | string or null | No | Department |
| `AuthorizingProvider.Location.DepartmentIdentifiers` | Array of object | No | List of IDs specific to this department |
| `AuthorizingProvider.Location.DepartmentIdentifiers[].ID` | string or null | No | An ID specific to this department |
| `AuthorizingProvider.Location.DepartmentIdentifiers[].IDType` | string or null | No | The source or system to which this ID pertains. *Could be an OID or a human-readable name* |
| `AuthorizingProvider.Location.Room` | string or null | No | Room. *Example: 136* |

## Example

```json
{
  "Meta": {
    "DataModel": "Clinical Decisions",
    "EventType": "Request",
    "EventDateTime": "2026-11-18T19:05:05.809Z",
    "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
  },
  "Session": {
    "Questions": [
      {
        "Question": {
          "Code": null,
          "Codeset": null,
          "Description": null
        },
        "Answer": {
          "Code": null,
          "Codeset": null,
          "Description": 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": []
  },
  "OrderingProvider": {
    "ID": "4236464757",
    "IDType": "NPI",
    "FirstName": "John",
    "LastName": "Slate",
    "Credentials": [
      "DO"
    ],
    "Address": {
      "StreetAddress": "500 First St.",
      "City": "Clayton",
      "State": "MO",
      "ZIP": "63105",
      "County": "Saint Louis",
      "Country": "USA"
    },
    "EmailAddresses": [],
    "PhoneNumber": {
      "Office": "+13145554321"
    },
    "Location": {
      "Type": null,
      "Facility": null,
      "FacilityIdentifiers": [],
      "Department": null,
      "DepartmentIdentifiers": [],
      "Room": null
    }
  },
  "AuthorizingProvider": {
    "ID": "4356789876",
    "IDType": "NPI",
    "FirstName": "Pat",
    "LastName": "Granite",
    "Credentials": [
      "MD"
    ],
    "Address": {
      "StreetAddress": "123 Main St.",
      "City": "Madison",
      "State": "WI",
      "ZIP": "53703",
      "County": "Dane",
      "Country": "USA"
    },
    "EmailAddresses": [],
    "PhoneNumber": {
      "Office": "+16085551234"
    },
    "Location": {
      "Type": null,
      "Facility": null,
      "FacilityIdentifiers": [],
      "Department": null,
      "DepartmentIdentifiers": [],
      "Room": null
    }
  },
  "UnsignedMedicationOrders": [
    {
      "Identifiers": [
        {
          "ID": "384209384094849",
          "IDType": "EHR"
        }
      ],
      "Frequency": {
        "Period": "8",
        "Unit": "h"
      },
      "Product": {
        "Code": "104894",
        "Codeset": null,
        "Name": "Ondansetron 4 Mg Po Tbdp"
      },
      "Priority": "Stat",
      "Dose": {
        "Quantity": "4",
        "Units": "mg"
      },
      "Mode": "IP",
      "Route": "Oral",
      "StartDate": "2005-05-01T04:00:00.000Z",
      "EndDate": "2011-02-27T05:00:00.000Z",
      "MixtureType": null,
      "MixtureComponents": [
        {
          "Code": null,
          "CodeType": null,
          "Dose": {
            "Quantity": null,
            "Units": null
          }
        }
      ],
      "Questions": [
        {
          "Question": {
            "Code": null,
            "Codeset": null,
            "Description": "Why is this medication being ordered?"
          },
          "Answer": {
            "Code": null,
            "Codeset": null,
            "Description": "To prevent nausea after chemotherapy."
          }
        }
      ],
      "Notes": []
    }
  ],
  "UnsignedProcedureOrders": [
    {
      "Code": "76700",
      "Codeset": "CPT",
      "Description": null,
      "Identifiers": [
        {
          "ID": "329308430984409",
          "IDType": "EHR"
        }
      ],
      "ScheduledDate": "2005-07-02T04:00:00:000Z",
      "Mode": "IP",
      "BodySite": {
        "Code": null,
        "Codeset": null,
        "Description": null
      },
      "StartDate": "2005-05-01T04:00:00.000Z",
      "EndDate": "2011-02-27T05:00:00.000Z",
      "Questions": [
        {
          "Question": {
            "Code": null,
            "Codeset": null,
            "Description": "Why is this ultrasound being ordered?"
          },
          "Answer": {
            "Code": null,
            "Codeset": null,
            "Description": "The patient swallowed a foreign body."
          }
        }
      ],
      "Notes": []
    }
  ]
}
```
