The Oracle Health Data Intelligence Longitudinal Record is a comprehensive clinical summary for a patient in context of a population. The Longitudinal Record is comprised of aggregated patient data from multiple data sources.
Note: The data retrieved by this API is filtered based on the sensitive data filters for Health Data Intelligence. Ensure that your implementations of this API are designed with this in mind, and if you integrate data from Health Data Intelligence into a clinical workflow using this API, ensure that your users are informed of your sensitive data filters. See Understand Sensitive Data in Oracle Health Data Intelligence in the Reference Pages on Cerner Wiki for more information.
The Medication Dispense resource covers the supply of medications to a patient. Examples include dispensing and pick-up from an outpatient or community pharmacy, dispensing patient-specific medications from an inpatient pharmacy to a ward, as well as issuing a single dose from a ward stock to a patient for consumption. The medication dispense is the result of a pharmacy system responding to a medication order.
Retrieve a Single Medication Dispense
Example Request:
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/medication-dispenses/f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/medication-dispenses/f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8 \-H'Authorization: {auth_header}'\-H'Accept: application/json'
Example response
{"id":"f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8","sourceIdentifier":{"dataPartitionId":"2e07f958-82fe-470b-871d-3f7227800a63","id":"12345"},"status":{"sourceCodings":[{"system":"2.16.840.1.113883.4.642.1.101","code":"completed","display":"Completed"}],"codings":[{"system":"2.16.840.1.113883.4.642.1.101","code":"completed","display":"Completed"}],"text":"Completed","concepts":[{"contextId":"00E15C00948B455F8349272E2830D6AF","alias":"COMPLETED_ORDSTAT"}]},"medications":[{"code":{"codings":[{"code":"00005310141","display":"acetaminophen 500 mg ORAL TABLET","system":"urn:oid:2.16.840.1.113883.3.567.12.1"}],"sourceCodings":[{"code":"12345","display":"acetaminophen 500 mg ORAL TABLET","system":"urn:oid:2.16.840.1.113883.3.567.12.1"}],"concepts":[{"contextId":"13A955381FD04E238BEC48D851F04FF9","alias":"D00049"}],"text":"acetaminophen 500 mg ORAL TABLET"},"dose":{"strength":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1"}],"text":"TABLET"},"value":"30"},"quantity":{"value":"1"},"volume":{"unit":{"codings":[{"code":"385055001","display":"Tablet","system":"2.16.840.1.113883.6.96"}],"sourceCodings":[{"code":"385055001","display":"Tablet","system":"2.16.840.1.113883.6.96"}],"text":"Tablet"},"value":"1"}},"referenceDrug":{"brandType":"GENERIC","code":{"codings":[{"code":"00005310141","display":"acetaminophen 500 mg ORAL TABLET","system":"2.16.840.1.113883.6.69"}],"text":"acetaminophen 500 mg ORAL TABLET"},"dosageForm":{"codings":[{"code":"C42998","display":"Tablet","system":"2.16.840.1.113883.3.26.1.1"}],"text":"Tablet"},"route":{"codings":[{"code":"C38288","display":"ORAL","system":"2.16.840.1.113883.3.26.1.1"}],"text":"ORAL"},"referenceIngredients":[{"code":{"codings":[{"code":"50458014130","display":"Canagliflozin 300 mg oral tablet","system":"2.16.840.1.113883.6.69"}],"sourceCodings":[{"code":"50458014130","display":"Canagliflozin 300 mg oral tablet","system":"2.16.840.1.113883.6.69"}],"text":"Canagliflozin 300 mg oral tablet"},"strength":{"numerator":{"value":"30","unit":{"sourceCodings":[{"system":"urn:cerner:coding:codingsystem:codeset:54","code":"293","display":"mL"}],"codings":[{"system":"2.16.840.1.113883.6.8","code":"mL"}],"text":"mL"}},"denominator":{"value":"30","unit":{"sourceCodings":[{"system":"urn:cerner:coding:codingsystem:codeset:54","code":"293","display":"mL"}],"codings":[{"system":"2.16.840.1.113883.6.8","code":"mL"}],"text":"mL"}}}}]}}],"encounter":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"},"authorizingPrescription":{"id":"f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8"},"type":{"sourceCodings":[{"system":"2.16.840.1.113883.1.11.16208","code":"RF","display":"Refill"}],"codings":[{"system":"2.16.840.1.113883.1.11.16208","code":"RF","display":"Refill"}],"text":"Refill"},"quantity":{"value":"30","unit":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"46992007","display":"tablet"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"46992007","display":"Pill"}],"text":"Pill"}},"daysSupply":{"value":"90","unit":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"258703001","display":"days"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"258703001","display":"day"}],"text":"day"}},"whenHandedOver":"2013-06-07","aliases":[{"system":"system_value","value":"medication_alias"}],"dosageInstruction":{"doseAndRate":{"doseQuantity":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"}}},"dosages":[{"sequence":1,"text":"1 tab PO QD","additionalInstructions":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"311501008","display":"Half to one hour before food"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"311501008","display":"Half to one hour before food"}],"text":"Half to one hour before food"},"patientInstruction":"Take 1-2 tablets once daily at bedtime as needed for restless legs.","timing":{"repeat":{"bounds":{"duration":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"},"period":{"startDate":"1997-07-16","endDate":"1998-08-24"}},"count":30,"duration":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"}},"timingSchedule":"This data type allows many different expressions of the event timing. For example, every eight hours, three times a day, half an hour before breakfast for 10 days from 23-Dec 2011, 15 Oct 2013 through 17 Oct 2013, and 1 Nov 2013\"."},"asNeeded":{"takenOnlyAsNeeded":true,"precondition":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"122003","display":"Choroidal hemorrhage"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"122003","display":"Choroidal hemorrhage"}],"text":"Choroidal hemorrhage"}},"route":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"26643006","display":"Oral use"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"26643006","display":"Oral use"}],"text":"Oral use"},"dose":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"},"rate":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"}}],"shippingInformations":[{"carrierName":"FedEx","trackingNumber":"794809361804"}],"provenances":[{"entities":[{"role":{"sourceCodings":[{"code":"source","system":"2.16.840.1.113883.4.642.4.437","display":"Source"}],"codings":[{"code":"source","system":"2.16.840.1.113883.4.642.4.437","display":"Source"}],"text":"Source"},"what":{"documentReference":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"}}}],"agents":[{"type":{"sourceCodings":[{"code":"author","system":"2.16.840.1.113883.4.642.4.1131","display":"Author"}],"codings":[{"code":"author","system":"2.16.840.1.113883.4.642.4.1131","display":"Author"}],"text":"Author"},"who":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}}}],"recordedOn":"2011-07-26T23:53:00.000Z"}],"refillsRemaining":2}
GET /populations/{populationId}/patients/{patientId}/medication-dispenses/{medicationDispenseId}
Retrieves a single medication dispense for a given patient.
Parameters
Parameter
In
Type
Required
Default
Description
Accepted Values
patientId
path
string
true
N/A
The ID of the patient.
-
populationId
path
string
true
N/A
The ID of the population.
-
medicationDispenseId
path
string
true
N/A
The unique ID of the medication dispense for the patient.
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/medication-dispenses',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/medication-dispenses \-H'Authorization: {auth_header}'\-H'Accept: application/json'
Example response
{"items":[{"id":"f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8","sourceIdentifier":{"dataPartitionId":"2e07f958-82fe-470b-871d-3f7227800a63","id":"12345"},"status":{"sourceCodings":[{"system":"2.16.840.1.113883.4.642.1.101","code":"completed","display":"Completed"}],"codings":[{"system":"2.16.840.1.113883.4.642.1.101","code":"completed","display":"Completed"}],"text":"Completed","concepts":[{"contextId":"00E15C00948B455F8349272E2830D6AF","alias":"COMPLETED_ORDSTAT"}]},"medications":[{"code":{"codings":[{"code":"00005310141","display":"acetaminophen 500 mg ORAL TABLET","system":"urn:oid:2.16.840.1.113883.3.567.12.1"}],"sourceCodings":[{"code":"12345","display":"acetaminophen 500 mg ORAL TABLET","system":"urn:oid:2.16.840.1.113883.3.567.12.1"}],"concepts":[{"contextId":"13A955381FD04E238BEC48D851F04FF9","alias":"D00049"}],"text":"acetaminophen 500 mg ORAL TABLET"},"dose":{"strength":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1"}],"text":"TABLET"},"value":"30"},"quantity":{"value":"1"},"volume":{"unit":{"codings":[{"code":"385055001","display":"Tablet","system":"2.16.840.1.113883.6.96"}],"sourceCodings":[{"code":"385055001","display":"Tablet","system":"2.16.840.1.113883.6.96"}],"text":"Tablet"},"value":"1"}},"referenceDrug":{"brandType":"GENERIC","code":{"codings":[{"code":"00005310141","display":"acetaminophen 500 mg ORAL TABLET","system":"2.16.840.1.113883.6.69"}],"text":"acetaminophen 500 mg ORAL TABLET"},"dosageForm":{"codings":[{"code":"C42998","display":"Tablet","system":"2.16.840.1.113883.3.26.1.1"}],"text":"Tablet"},"route":{"codings":[{"code":"C38288","display":"ORAL","system":"2.16.840.1.113883.3.26.1.1"}],"text":"ORAL"},"referenceIngredients":[{"code":{"codings":[{"code":"50458014130","display":"Canagliflozin 300 mg oral tablet","system":"2.16.840.1.113883.6.69"}],"sourceCodings":[{"code":"50458014130","display":"Canagliflozin 300 mg oral tablet","system":"2.16.840.1.113883.6.69"}],"text":"Canagliflozin 300 mg oral tablet"},"strength":{"numerator":{"value":"30","unit":{"sourceCodings":[{"system":"urn:cerner:coding:codingsystem:codeset:54","code":"293","display":"mL"}],"codings":[{"system":"2.16.840.1.113883.6.8","code":"mL"}],"text":"mL"}},"denominator":{"value":"30","unit":{"sourceCodings":[{"system":"urn:cerner:coding:codingsystem:codeset:54","code":"293","display":"mL"}],"codings":[{"system":"2.16.840.1.113883.6.8","code":"mL"}],"text":"mL"}}}}]}}],"encounter":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"},"authorizingPrescription":{"id":"f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8"},"type":{"sourceCodings":[{"system":"2.16.840.1.113883.1.11.16208","code":"RF","display":"Refill"}],"codings":[{"system":"2.16.840.1.113883.1.11.16208","code":"RF","display":"Refill"}],"text":"Refill"},"quantity":{"value":"30","unit":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"46992007","display":"tablet"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"46992007","display":"Pill"}],"text":"Pill"}},"daysSupply":{"value":"90","unit":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"258703001","display":"days"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"258703001","display":"day"}],"text":"day"}},"whenHandedOver":"2013-06-07","aliases":[{"system":"system_value","value":"medication_alias"}],"dosageInstruction":{"doseAndRate":{"doseQuantity":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"}}},"dosages":[{"sequence":1,"text":"1 tab PO QD","additionalInstructions":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"311501008","display":"Half to one hour before food"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"311501008","display":"Half to one hour before food"}],"text":"Half to one hour before food"},"patientInstruction":"Take 1-2 tablets once daily at bedtime as needed for restless legs.","timing":{"repeat":{"bounds":{"duration":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"},"period":{"startDate":"1997-07-16","endDate":"1998-08-24"}},"count":30,"duration":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"}},"timingSchedule":"This data type allows many different expressions of the event timing. For example, every eight hours, three times a day, half an hour before breakfast for 10 days from 23-Dec 2011, 15 Oct 2013 through 17 Oct 2013, and 1 Nov 2013\"."},"asNeeded":{"takenOnlyAsNeeded":true,"precondition":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"122003","display":"Choroidal hemorrhage"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"122003","display":"Choroidal hemorrhage"}],"text":"Choroidal hemorrhage"}},"route":{"sourceCodings":[{"system":"2.16.840.1.113883.6.96","code":"26643006","display":"Oral use"}],"codings":[{"system":"2.16.840.1.113883.6.96","code":"26643006","display":"Oral use"}],"text":"Oral use"},"dose":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"},"rate":{"unit":{"codings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"sourceCodings":[{"code":"C42998","display":"TABLET","system":"2.16.840.1.113883.3.26.1.1.2"}],"text":"TABLET"},"value":"1"}}],"shippingInformations":[{"carrierName":"FedEx","trackingNumber":"794809361804"}],"provenances":[{"entities":[{"role":{"sourceCodings":[{"code":"source","system":"2.16.840.1.113883.4.642.4.437","display":"Source"}],"codings":[{"code":"source","system":"2.16.840.1.113883.4.642.4.437","display":"Source"}],"text":"Source"},"what":{"documentReference":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"}}}],"agents":[{"type":{"sourceCodings":[{"code":"author","system":"2.16.840.1.113883.4.642.4.1131","display":"Author"}],"codings":[{"code":"author","system":"2.16.840.1.113883.4.642.4.1131","display":"Author"}],"text":"Author"},"who":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}}}],"recordedOn":"2011-07-26T23:53:00.000Z"}],"refillsRemaining":2}],"firstLink":"https://cernerdemo.api.us.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/medication-dispenses?limit=20","nextLink":"https://cernerdemo.api.us.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/medication-dispenses?cursor=f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8&limit=20"}
GET /populations/{populationId}/patients/{patientId}/medication-dispenses
Retrieves a list of the medication dispenses for a given patient.
Parameters
Parameter
In
Type
Required
Default
Description
Accepted Values
patientId
path
string
true
N/A
The ID of the patient.
-
populationId
path
string
true
N/A
The ID of the population.
-
cursor
query
string
false
0
A marker indicating the position of the last item retrieved for a response. If you specify this parameter, the response begins with the next item on the list.
-
limit
query
integer(int32)
false
20
The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100.
-
status
query
array[string]
false
N/A
The alias values for document status concepts by which results should be filtered.
Filters the list based on the type’s concept. A concept consists of a contextId and alias concatenated together with a vertical bar (|). To ensure the correct identification of the type’s concept, the contextId and alias must be an exact match. If a vertical bar occurs in either the contextId or alias, it must be escaped using an escape character (\), for example, contextId\|withVerticalBar|alias. If an escape character occurs in either the contextId or alias, it must also be escaped using an escape character, for example, contextId\\withEscape|alias.
-
code:coding
query
array[string]
false
N/A
Filters the list based on the type’s coding. A coding consists of a code and system concatenated together with a vertical bar (|). To ensure the correct identification of the type’s coding, the code and system must be an exact match. If a vertical bar occurs in either the code or system, it must be escaped using an escape character (\), for example, system\|withVerticalBar|code. If an escape character occurs in either the system or code, it must also be escaped using an escape character, for example, system\\withEscape|code.
-
code:sourceCoding
query
array[string]
false
N/A
Filters the list based on the type’s sourceCoding. A sourceCoding consists of a code and system concatenated together with a vertical bar (|). To ensure the correct identification of the type’s sourceCoding, the code and system must be an exact match. If a vertical bar occurs in either the code or system, it must be escaped using an escape character (\), for example, system\|withVerticalBar|code. If an escape character occurs in either the system or code, it must also be escaped using an escape character, for example, system\\withEscape|code.
-
code:text
query
array[string]
false
N/A
Filters the list based on the type’s text attribute
DocumentReference is used to index a document, diagnostic report, clinical note, or other binary object. The document establishes context through metadata (such as the author, description, or status) and references the binary contents of the document. The document contents can be any binary object with a recognized Multipurpose Internet Mail Extensions (MIME) type. For example, document contents can include structured documents in eXtensible Markup Language (XML), clinical notes in plain text, or a scanned report in Portable Document Format (PDF).
Retrieve a Single Document Reference
Example Request:
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/document-references/f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/document-references/f09385c8e68530e2227097cffb70e464437b6faf560ee3a8ffca84369291e2b8 \-H'Authorization: {auth_header}'\-H'Accept: application/json'
Example response
{"id":"581433f4-b179-3df4-9bb2-9768ef76493c","authenticator":{"type":"PROVIDER","provider":{"aliases":[{"system":"2.16.840.1.113883.4.814","value":"2112186","type":"DEA"}],"name":{"prefix":"Dr.","given":["Jane","Susannah"],"family":["Smith"],"suffix":"MD","formatted":"Dr. Jane Susannah Smith MD"}}},"categories":[{"sourceCodings":[],"codings":[{"system":"http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category","code":"clinical-note","display":"Clinical Note"}],"concepts":[{"contextId":"a092e06f-7690-4ace-a678-885913a35d46","alias":"CLINICAL_NOTE_OBSTYPE"}],"text":"Clinical Note"}],"dateTime":"2011-07-26T23:53:00.000Z","description":"Physician Emergency Department Note","docStatus":{"sourceCodings":[{"code":"25","display":"Auth (Verified)","system":"urn:cerner:coding:codingsystem:codeset:8"}],"codings":[{"code":"F","display":"Final results","system":"2.16.840.1.113883.12.85"}],"text":"Auth (Verified)"},"effectiveDate":"2011-07-26T20:53:00.000Z","encounter":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"},"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"7209f9fb-3a5d-44c1-8dbb-123f340a9850"},"type":{"sourceCodings":[{"system":"urn:cerner:coding:codingsystem:codeset:72","code":"3374547","display":"Depart Summary"}],"codings":[{"system":"2.16.840.1.113883.6.1","code":"68608-9","display":"Summary note"}],"text":"Depart Summary"},"authors":[{"type":"PROVIDER","provider":{"aliases":[{"system":"2.16.840.1.113883.4.814","value":"2112186","type":"DEA"}],"name":{"prefix":"Dr.","given":["Jane","Susannah"],"family":["Smith"],"suffix":"MD","formatted":"Dr. Jane Susannah Smith MD"}}}],"custodian":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}},"contents":[{"attachment":{"contentType":{"sourceCodings":[{"code":"text/plain","system":"urn:ietf:bcp:13","display":"text/plain"}],"codings":[{"code":"text/plain","system":"urn:ietf:bcp:13","display":"text/plain"}],"text":"text/plain"},"binary":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"},"size":"2048000","title":"Physician Emergency Department Note","creation":"2011-07-26T23:53:00.000Z"}}],"aliases":[{"system":"1.1.16.6","value":"2112186"}],"provenances":[{"entities":[{"role":{"sourceCodings":[{"code":"source","system":"2.16.840.1.113883.4.642.1.437","display":"Source"}],"codings":[{"code":"source","system":"2.16.840.1.113883.4.642.1.437","display":"Source"}],"text":"Source"},"what":{"documentReference":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"}}}],"agents":[{"type":{"sourceCodings":[{"code":"author","system":"2.16.840.1.113883.4.642.1.1131","display":"Author"}],"codings":[{"code":"author","system":"2.16.840.1.113883.4.642.1.1131","display":"Author"}],"text":"Author"},"who":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}}}],"recordedOn":"2011-07-26T23:53:00.000Z"}],"securityLabels":[{"sourceCodings":[{"system":"2.16.840.1.113883.5.25","code":"N","display":"normal"}],"codings":[{"system":"2.16.840.1.113883.5.25","code":"N","display":"normal"}],"text":"normal"}]}
GET /populations/{populationId}/patients/{patientId}/document-references/{documentReferenceId}
Retrieves a single document reference for a given patient.
Parameters
Parameter
In
Type
Required
Default
Description
Accepted Values
patientId
path
string
true
N/A
The ID of the patient.
-
populationId
path
string
true
N/A
The ID of the population.
-
documentReferenceId
path
string
true
N/A
The unique ID of the document reference for the patient.
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/document-references',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/document-references \-H'Authorization: {auth_header}'\-H'Accept: application/json'
Example response
{"items":[{"id":"98851171-d7e6-4f51-bdc2-363b8240909f","authenticator":{"type":"PROVIDER","provider":{"aliases":[{"system":"2.16.840.1.113883.12.443","value":"1547428","type":"Admitting"}],"name":{"prefix":"Dr.","given":["Mark","Alexander"],"family":["Joseph"],"suffix":"MD","formatted":"Dr. Mark Alexander Joseph MD"}}},"categories":[{"sourceCodings":[],"codings":[{"system":"2.16.840.1.113883.6.1","code":"LP29684-5","display":"Radiology"}],"concepts":[{"contextId":"a092e06f-7690-4ace-a678-885913a35d46","alias":"RADIOLOGY_REPORT_OBSTYPE"}],"text":"Radiology Report"}],"dateTime":"2019-02-20T19:45:00.000Z","description":"MRI ABDOMEN WITH CONTRAST","docStatus":{"sourceCodings":[{"code":"25","display":"Auth (Verified)","system":"urn:cerner:coding:codingsystem:codeset:8"}],"codings":[{"code":"F","display":"Final results","system":"2.16.840.1.113883.12.85"}],"text":"Auth (Verified)"},"effectivePeriod":{"start":"2019-02-20T19:45:00.000Z","end":"2019-02-21T20:55:00.000Z"},"encounter":{"id":"069a30bf-ff98-38b5-a723-c1c2ecc287a5"},"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"25531559-0b77-4b76-bc75-0ff2cd8c6f06"},"type":{"sourceCodings":[{"system":"2.16.840.1.113883.6.1","code":"68604-8","display":"Radiology Diagnostic study note"}],"codings":[{"system":"2.16.840.1.113883.6.1","code":"68604-8","display":"Radiology Diagnostic study note"}],"text":"Radiology Diagnostic study note"},"authors":[{"type":"PROVIDER","provider":{"aliases":[{"system":"2.16.840.1.113883.4.6","value":"1497758121","type":"NPI"}],"name":{"prefix":"Dr.","given":["Mark","Alexander"],"family":["Joseph"],"suffix":"MD","formatted":"Dr. Mark Alexander Joseph MD"}}}],"custodian":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}},"contents":[{"format":{"sourceCodings":[{"code":"urn:ihe:rad:PDF","system":"1.3.6.1.4.1.19376.1.2.7.1","display":"XDS-I PDF (XDS-I)"}],"codings":[{"code":"urn:ihe:rad:PDF","system":"1.3.6.1.4.1.19376.1.2.7.1","display":"XDS-I PDF (XDS-I)"}],"text":"XDS-I PDF (XDS-I)"},"attachment":{"contentType":{"sourceCodings":[{"code":" application/pdf","system":"urn:ietf:bcp:13","display":" application/pdf"}],"codings":[{"code":" application/pdf","system":"urn:ietf:bcp:13","display":" application/pdf"}],"text":"application/pdf"},"binary":{"id":"681433f4-b174-3df4-9bb1-9768ef76474d"},"size":"2048000","title":"MRI ABDOMEN WITH CONTRAST","creation":"2019-02-21T20:55:00.000Z"}}],"aliases":[{"system":"1.1.16.6","value":"1547428"}],"provenances":[{"entities":[{"role":{"sourceCodings":[{"code":"source","system":"2.16.840.1.113883.4.642.1.437","display":"Source"}],"codings":[{"code":"source","system":"2.16.840.1.113883.4.642.1.437","display":"Source"}],"text":"Source"},"what":{"documentReference":{"id":"a07aa74e-41b4-485a-b9be-b08c383db763"}}}],"agents":[{"type":{"sourceCodings":[{"code":"author","system":"2.16.840.1.113883.4.642.1.1131","display":"Author"}],"codings":[{"code":"author","system":"2.16.840.1.113883.4.642.1.1131","display":"Author"}],"text":"Author"},"who":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}}}],"recordedOn":"2019-02-21T20:55:00.000Z"}],"securityLabels":[{"sourceCodings":[{"system":"2.16.840.1.113883.5.25","code":"N","display":"normal"}],"codings":[{"system":"2.16.840.1.113883.5.25","code":"N","display":"normal"}],"text":"normal"}]},{"id":"581433f4-b179-3df4-9bb2-9768ef76493c","authenticator":{"type":"PROVIDER","provider":{"aliases":[{"system":"2.16.840.1.113883.4.814","value":"2112186","type":"DEA"}],"name":{"prefix":"Dr.","given":["Jane","Susannah"],"family":["Smith"],"suffix":"MD","formatted":"Dr. Jane Susannah Smith MD"}}},"categories":[{"sourceCodings":[],"codings":[{"system":"http://hl7.org/fhir/us/core/CodeSystem/us-core-documentreference-category","code":"clinical-note","display":"Clinical Note"}],"concepts":[{"contextId":"a092e06f-7690-4ace-a678-885913a35d46","alias":"CLINICAL_NOTE_OBSTYPE"}],"text":"Clinical Note"}],"dateTime":"2011-07-26T23:53:00.000Z","description":"Physician Emergency Department Note","docStatus":{"sourceCodings":[{"code":"25","display":"Auth (Verified)","system":"urn:cerner:coding:codingsystem:codeset:8"}],"codings":[{"code":"F","display":"Final results","system":"2.16.840.1.113883.12.85"}],"text":"Auth (Verified)"},"effectiveDate":"2011-07-26T20:53:00.000Z","encounter":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"},"sourceIdentifier":{"dataPartitionId":"e5f34c23-e572-44c3-a2cd-7ca358dcec9f","id":"7209f9fb-3a5d-44c1-8dbb-123f340a9850"},"type":{"sourceCodings":[{"system":"urn:cerner:coding:codingsystem:codeset:72","code":"3374547","display":"Depart Summary"}],"codings":[{"system":"2.16.840.1.113883.6.1","code":"68608-9","display":"Summary note"}],"text":"Depart Summary"},"authors":[{"type":"PROVIDER","provider":{"aliases":[{"system":"2.16.840.1.113883.4.814","value":"2112186","type":"DEA"}],"name":{"prefix":"Dr.","given":["Jane","Susannah"],"family":["Smith"],"suffix":"MD","formatted":"Dr. Jane Susannah Smith MD"}}}],"custodian":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}},"contents":[{"attachment":{"contentType":{"sourceCodings":[{"code":"text/plain","system":"urn:ietf:bcp:13","display":"text/plain"}],"codings":[{"code":"text/plain","system":"urn:ietf:bcp:13","display":"text/plain"}],"text":"text/plain"},"binary":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"},"size":"2048000","title":"Physician Emergency Department Note","creation":"2011-07-26T23:53:00.000Z"}}],"aliases":[{"system":"1.1.16.6","value":"2112186"}],"provenances":[{"entities":[{"role":{"sourceCodings":[{"code":"source","system":"2.16.840.1.113883.4.642.1.437","display":"Source"}],"codings":[{"code":"source","system":"2.16.840.1.113883.4.642.1.437","display":"Source"}],"text":"Source"},"what":{"documentReference":{"id":"581433f4-b179-3df4-9bb2-9768ef76493c"}}}],"agents":[{"type":{"sourceCodings":[{"code":"author","system":"2.16.840.1.113883.4.642.1.1131","display":"Author"}],"codings":[{"code":"author","system":"2.16.840.1.113883.4.642.1.1131","display":"Author"}],"text":"Author"},"who":{"organization":{"name":"Rockcreek Clinic","aliases":[{"value":"151579","type":"EXTERNAL","system":"1.2.3.4.5.6.7.8.9.10.1"}]}}}],"recordedOn":"2011-07-26T23:53:00.000Z"}],"securityLabels":[{"sourceCodings":[{"system":"2.16.840.1.113883.5.25","code":"N","display":"normal"}],"codings":[{"system":"2.16.840.1.113883.5.25","code":"N","display":"normal"}],"text":"normal"}]}],"firstLink":"https://cernerdemo.api.us.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/a2f6a16d-1331-4ccc-8f70-6c4d953ba70b/document-references?limit=20","nextLink":"https://cernerdemo.api.us.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/a2f6a16d-1331-4ccc-8f70-6c4d953ba70b/document-references?cursor=581433f4-b179-3df4-9bb2-9768ef76493c&limit=20"}
GET /populations/{populationId}/patients/{patientId}/document-references
Retrieves a list of the document references for a given patient.
Parameters
Parameter
In
Type
Required
Default
Description
Accepted Values
patientId
path
string
true
N/A
The ID of the patient.
-
populationId
path
string
true
N/A
The ID of the population.
-
cursor
query
string
false
0
A marker indicating the position of the last item retrieved for a response. If you specify this parameter, the response begins with the next item on the list.
-
limit
query
integer(int32)
false
20
The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100.
-
category
query
array[string]
false
N/A
The alias values for category concepts by which results should be filtered.
Filters the list based on the type’s concept. A concept consists of a contextId and alias concatenated together with a vertical bar (|). To ensure the correct identification of the type’s concept, the contextId and alias must be an exact match. If a vertical bar occurs in either the contextId or alias, it must be escaped using an escape character (\), for example, contextId\|withVerticalBar|alias. If an escape character occurs in either the contextId or alias, it must also be escaped using an escape character, for example, contextId\\withEscape|alias.
-
type:coding
query
array[string]
false
N/A
Filters the list based on the type’s coding. A coding consists of a code and system concatenated together with a vertical bar (|). To ensure the correct identification of the type’s coding, the code and system must be an exact match. If a vertical bar occurs in either the code or system, it must be escaped using an escape character (\), for example, system\|withVerticalBar|code. If an escape character occurs in either the system or code, it must also be escaped using an escape character, for example, system\\withEscape|code.
-
type:sourceCoding
query
array[string]
false
N/A
Filters the list based on the type’s sourceCoding. A sourceCoding consists of a code and system concatenated together with a vertical bar (|). To ensure the correct identification of the type’s sourceCoding, the code and system must be an exact match. If a vertical bar occurs in either the code or system, it must be escaped using an escape character (\), for example, system\|withVerticalBar|code. If an escape character occurs in either the system or code, it must also be escaped using an escape character, for example, system\\withEscape|code.
-
type:text
query
array[string]
false
N/A
Filters the list based on the type’s text attribute.
A binary represents the data of a single raw artifact as digital content accessible in its native format. A binary resource can contain any content, whether text, image, .PDF file, .ZIP file, and so on.
Retrieve a Binary
Example Request:
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/binaries/bc5769fa-ffc0-11e7-a3d6-46705f8c9e89',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/patients/0f2fbbc9-7c18-45e0-a95e-89076c8a9581/binaries/bc5769fa-ffc0-11e7-a3d6-46705f8c9e89 \-H'Authorization: {auth_header}'\-H'Accept: application/json'
GET /populations/{populationId}/patients/{patientId}/binaries/{binaryId}
Retrieves a binary for a given patient.
Parameters
Parameter
In
Type
Required
Default
Description
Accepted Values
patientId
path
string
true
N/A
The ID of the patient.
-
populationId
path
string
true
N/A
The ID of the population.
-
binaryId
path
string
true
N/A
The ID that uniquely identifies the binary for the patient.
The Bulk Extract resource represents a request for an export of electronic health information (EHI) from a customer’s Longitudinal Record that is made available for download through the Data Syndication API.
Cancel a Bulk Extract
Example Request:
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.post('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts/944bf17a-09c7-438c-a3d1-37fefc8334ca/cancel',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts/944bf17a-09c7-438c-a3d1-37fefc8334ca/cancel \-H'Authorization: {auth_header}'\-H'Accept: application/json'
POST /populations/{populationId}/bulk-extracts/{bulkExtractId}/cancel
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts/944bf17a-09c7-438c-a3d1-37fefc8334ca',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts/944bf17a-09c7-438c-a3d1-37fefc8334ca \-H'Authorization: {auth_header}'\-H'Accept: application/json'
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Content-Type'=>'application/json','Accept'=>'application/json'}result=HTTParty.post('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts \-H'Authorization: {auth_header}'\-H'Content-Type: application/json'\-H'Accept: application/json'
require'httparty'# Using HTTParty 0.16.2require'json'headers={'Authorization'=>'<auth_header>','Accept'=>'application/json'}result=HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts',headers: headers)printJSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/longitudinal-record/v1/populations/1424e81d-8cea-4d6b-b140-d6630b684a58/bulk-extracts \-H'Authorization: {auth_header}'\-H'Accept: application/json'
The status of the document, such as preliminary or final.
-
effectiveDate
string
false
The clinically significant date and time when the service that is described by the document was provided. In International Organization for Standardization (ISO) 8601 formatting with precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ. For a given documentReference, either effectiveDate or effectivePeriod is valued.
The clinically significant time period over which the service that is described by the document was provided. For a given documentReference, either effectiveDate or effectivePeriod is valued.
The business identifiers by which the document or report is known, such as the Digital Imaging and Communications in Medicine (DICOM) study instance unique identifier (UID) or accession number for diagnostic reports.
The record-keeping assertions about the context in which the information in this document reference was obtained (for example, the authoring organization, the transmitter or custodian organization that informs the chain of custody, or the source CCDA document from which this document reference was derived, if applicable).
A set of Security-Tag codes specifying the level of privacy or security of the document. This represents a snapshot of the security labels on the document the reference refers to.
-
Authenticator
Name
Type
Required
Description
Accepted Values
type
string
false
The kind of entity that authenticates or signs the document conveying that the document is valid.
The authority responsible for assigning the alias value. Alias values are unique within this system namespace but not across systems.
-
value
string
false
The unique ID of the provider in the context of the system or assigning authority.
-
type
string
true
The type of alias.
DEA, EXTERNAL, NPI, SL, TAX, UPIN
ProviderName
Name
Type
Required
Description
Accepted Values
prefix
string
false
The parts that come before the name such as Dr., Mr., or Mrs.
-
given
[string]
true
A list of given name portions of the person’s name. For example, if a person has a first name and a middle name, the first name should be the first item on the list and the middle name should be the second item on the list.
-
family
[string]
true
A list of family (last) name portions of the person’s name. Some people have multiple family names.
-
suffix
string
false
The parts that come after the name such as MD, III, or Jr.
The list of codified values provided in the source data. Not all of these codes are available in the codings list. For example, local or proprietary codes are not included on the codings list because they are not recognized by Health Data Intelligence.
The list of ontological concepts derived from the codified values from standard code systems recognized by Health Data Intelligence.
-
text
string
false
This may be a localized or annotated description of the element provided by a source system or display text associated with one of the codes on the codings or sourceCodings list.
-
Code
Name
Type
Required
Description
Accepted Values
code
string
true
The unique ID of the code.
-
display
string
false
A human-readable representation of the code.
-
system
string
true
The ID of the coding system that gives meaning to the code.
-
Concept
Name
Type
Required
Description
Accepted Values
alias
string
true
The unique ID of the concept in a context.
-
contextId
string
true
The unique ID of the context. IDs are all uppercase and do not include dashes.
-
Period
Name
Type
Required
Description
Accepted Values
start
string
false
The start date of the period. In ISO 8601 formatting with precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ.
-
end
string
false
The end date of the period. In ISO 8601 formatting with precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ.
-
EncounterId
Name
Type
Required
Description
Accepted Values
id
string
false
The unique ID of the encounter.
-
SourceIdentifier
Name
Type
Required
Description
Accepted Values
dataPartitionId
string
false
The ID of the data partition. See the Data Partitions endpoint of the Data Source API for more information.
-
id
string
false
An ID that uniquely identifies this document reference for a patient in a data partition.
-
Author
Name
Type
Required
Description
Accepted Values
type
string
false
The kind of entity that was responsible for adding information to the document.
The medication or drug being dispensed to the patient. This value may not exactly match the provider- or physician-ordered medication. The drug name and dose information of the medication may be included.
The total amount of medication that has been dispensed for the event, such as how many pills in the bottle for the days’ supply or how many inhalers dispensed. For example, if the order was to take two tablets daily for 30 days, then the total quantity would be 60 tablets for a 30-day supply. The unit of measure is included.
The number of days the medication amount dispensed is expected to last. This value is expressed as a timing amount.
-
whenHandedOver
string
false
The date and time the dispensed medication was provided to the patient or their representative in International Organization for Standardization (ISO) 8601 extended format, with precision ranging from YYYY to YYYY-MM-DDThh:mm:ss.SSSZ (for example, 1997 through 1997-07-16T19:20:00.000Z), although equivalent ISO 8601 basic format is also allowed (for example, YYYYMMDD).
The identifiers associated with the medication that are defined by business processes. The identifiers can be used to reference the medication as they remain constant as the medication is updated.
The record-keeping assertions about the context in which the information in this medication was obtained. For example, the authoring organization, the transmitter or custodian organization that informs the chain of custody, or the source Consolidated Clinical Document Architecture (C-CDA) document from which this medication was derived, if applicable.
-
refillsRemaining
integer(int32)
false
The number of refills allowed or remaining after a dispensing event. The current dispense is not included.
The identification of an ingredient in the medication that was dispensed. The ingredient code can have varying degrees of specificity, such as noncodified free text, a simple codified generic ingredient, a codified brand name, a precoordinated code that conveys the ingredient, or a brand name with its strength and dose form. For example, a dispensed total parenteral nutrition (TPN) has multiple ingredient codes that may include dextrose, potassium, magnesium, zinc, calcium, lipids, and multivitamins.
The dose strength of the medication ingredient. The dose strength can differ from the reference drug’s strength, which describes the strength of the drug itself. For example, a patient who is instructed to take two 20 mg tablets implies a reference drug strength of 20 mg, whereas the dose strength is 40 mg.
The unit of measure associated with the dose quantity.
-
value
string
false
The numeric value of the quantity.
-
ReferenceDrug
Name
Type
Required
Description
Accepted Values
brandType
string
false
Designates whether the drug is a brand name or generic product. The designation is based on internal editorial rules and cost algorithms that are used to determine whether a multisource drug is generic.
The strength of the drug. The strength can differ from the ingredient’s dose strength, which defines the intended dose per administration event. For example, a patient who is instructed to take two 20 mg tablets implies a reference drug strength of 20 mg, whereas the dose strength is 40 mg. Strength is conveyed via a ratio where 100 mg is the numerator and one each is the denominator.
The amount of medication or substance per unit of time, such as how many pills are taken per administration event. For example, if the order was to take two tablets daily for 30 days, then the dose quantity is two. Note:doseQuantity refers to the quantity of the specified medication, not the quantity of active ingredients.
-
Dosage
Name
Type
Required
Description
Accepted Values
sequence
integer(int32)
false
The order of dosage instructions. This order is applicable to tapered dosings.
-
text
string
false
Free text dosage instructions. For example, the sig line.
The amount of medication or substance per unit of time, such as how many pills are taken per administration event. For example, if the order was to take two tablets daily for 30 days, then the dose quantity is two. Note: This refers to the quantity of the specified medication, not the quantity of active ingredients.
The number of times the dose is repeated, or the length of time for the dose. The specification of how long it takes to administer one dose is also available.
The timing schedule for giving the medication to the patient. Sometimes, a rate can imply duration when expressed as the total volume and duration. For example, 500mL/2 hours implies a duration of two hours. However, when rate does not imply duration, for example, 250mL/hour, the timing repeat duration is needed to convey the infusion over a period of time.
A duration for the length of the timing schedule, a range of the possible length,or outer bounds for start and end limits of the timing schedule. You must use the schedule duration or the schedule start and end times.
-
count
integer(int32)
false
The number of times to repeat an event that is represented by a positive integer.
A list of IDs for the patient that are intended to facilitate interoperability among systems and commonly and uniquely identify the individual.
-
PatientAlias
Name
Type
Required
Description
Accepted Values
value
string
true
The ID issued by the assigning authority. The formatting may vary by source or alias type.
-
computationalValue
string
false
The formatted version of the alias value that is unique in the system and can be used for computational mapping (for example, removing nonsignificant whitespace, dashes, and so on).
-
renderedValue
string
false
The rendered version of the alias value intended for human display. For example, a sensitive ID (such as a Social Security number (SSN)) partially obscured by asterisks or a driver’s license number with dashes inserted.
-
system
string
true
The authority responsible for assigning the alias value. Alias values may be unique in each system but not across systems. For example, an MRN with a value of 12345 in one hospital’s system may represent a different person than MRN 12345 in a different hospital’s system. Health Data Intelligence avoids identity collisions by indicating the authority that assigned the alias. Ignoring the assigning authority presents security and data integrity concerns, for example, data being associated with the wrong patient or record.
The type of the alias, for example, medical record number (MRN) or National Health Service (NHS).
-
Tag
Name
Type
Required
Description
Accepted Values
key
string
true
The tag key to search for. The search will be on exact matches.
-
value
string
false
The tag value to search for. The search will be on exact matches.
-
Meta
Name
Type
Required
Description
Accepted Values
deliveryId
string
false
The ID of the extract delivery accessible through the Data Syndication API. Only valued if the extract is in a COMPLETED status and at least one resource qualified for the extract. If zero resources qualified, ‘deliveryId’ is not valued.
-
Filters
Name
Type
Required
Description
Accepted Values
patientId
string
false
If specified, the extract will only contain this specified patient.
-
Error
Name
Type
Required
Description
Accepted Values
code
integer(int32)
true
The HTTP response status code that represents the error.
