Get a list of observations
get
/Observation
Retrieves a list of labatory, vital sign, and alcohol or tobacco use observations that meet supplied query parameters.
Note:
- Currently, the
comments
field may have RTF or other formatted data rather than simple text. A resolution for this issue is planned with an R4 release. - When multiple pages of observation results are returned for a single query:
- All social history observations (if any qualify for the query) are returned on the first page of results. The next item on this list does not apply to social history observations.
- Results are sorted by effective date and time in descending order. In other words, all observations on any given page of results are newer than all observations on the next page of results. Sort order within pages is not guaranteed.
- If the query uses the
_lastUpdated
query parameter, results are sorted by last updated date and time in descending order by page, not by effective date and time.
- Oracle recommends searching by
code
,date
, or both.
Request
Query Parameters
-
_count: string
The maximum number of results to return per page. Defaults to 50 and maximum 200 observations can be returned
-
_lastUpdated: string
The date range when the observation was last updated.
- May be provided up to two times, and must use the
eq
,ge
,gt
,le
, orlt
prefixes. - When a value is provided without a prefix, an implied
eq
prefix is used. - When provided twice, the lower value must have a
ge
orgt
prefix and the higher value must have anle
orlt
prefix. - May not be provided with
date
. - Only qualifies clinically significant updates such as changes to the value or code, and other significant fields. Minor updates, such as non-clinically relevant note updates, do not qualify.
_lastUpdated=gt2014-09-24
or_lastUpdated=lt2015-09-24T12:00:00.000Z
- May be provided up to two times, and must use the
-
category: string
The category of observations.
Example:category=laboratory
-
code: string
The code or component-code of the observation type.
- May be a list of comma-separated values. A system must be provided for each code.
- Searches
Observation.code
andObservation.component.code
.
code=http://loinc.org|3094-0,http://loinc.org|3139-3
-
date: string
The date range that the observation falls within.
- May be provided up to two times, and must use the
eq
,ge
,gt
,le
, orlt
prefixes. - When a value is provided without a prefix, an implied
eq
prefix is used. - When provided twice, the lower value must have a
ge
orgt
prefix and the higher value must have anle
orlt
prefix. - May not be provided with
_lastUpdated
.
date=gt2014-09-24
ordate=lt2015-09-24T12:00:00.000Z
- May be provided up to two times, and must use the
-
patient: string
The subject (patient) that the observation is about. This parameter is required if
subject
is not used.
Example:patient=12345
-
subject: string
The subject (patient) that the observation is about. This parameter is required if
patient
is not used.
Example:subject=Patient/12345
orsubject:Patient=12345
Header Parameters
-
Accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
Response
Supported Media Types
- application/json+fhir
Default Response
This operation supports the following authorization types:
- Provider
- Patient
- System
GET https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation?patient=12724067
Example Response:
{
"resourceType": "Bundle",
"id": "32633969-4644-4075-8403-3c2169cb3ce1",
"type": "searchset",
"link": [
{
"relation": "self",
"url": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation?patient=12724067&_count=50"
}
],
"entry": [
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation/93-73033575",
"resource": {
"resourceType": "Observation",
"id": "93-73033575",
"meta": {
"versionId": "73033575",
"lastUpdated": "2019-12-26T19:25:58.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Observation</b></p><p><b>Patient</b>: 12724067</p><p><b>Date</b>: Dec 26, 2019 7:25 P.M. UTC</p><p><b>Status</b>: Final</p><p><b>Category</b>: Social History</p><p><b>Code</b>: Tobacco</p></div>"
},
"status": "final",
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "social-history",
"display": "Social History"
}
],
"text": "Social History"
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "229819007",
"display": "Tobacco use and exposure (observable entity)"
},
{
"system": "http://loinc.org",
"code": "72166-2"
}
],
"text": "Tobacco"
},
"subject": {
"reference": "Patient/12724067"
},
"issued": "2019-12-26T19:25:58.000Z",
"dataAbsentReason": {
"coding": [
{
"system": "http://hl7.org/fhir/data-absent-reason",
"code": "unknown",
"display": "Unknown"
}
],
"text": "Unknown"
},
"related": [
{
"type": "has-member",
"target": {
"reference": "Observation/73033575-q4625825"
}
}
]
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation/73033575-q4625825",
"resource": {
"resourceType": "Observation",
"id": "73033575-q4625825",
"meta": {
"versionId": "73033575",
"lastUpdated": "2019-12-26T19:25:58.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Observation</b></p><p><b>Patient</b>: 12724067</p><p><b>Date</b>: Dec 26, 2019 7:25 P.M. UTC</p><p><b>Status</b>: Final</p><p><b>Category</b>: Social History</p><p><b>Question</b>: SHX Tobacco use</p><p><b>Response</b>: Never (less than 100 in lifetime)</p></div>"
},
"status": "final",
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "social-history",
"display": "Social History"
}
],
"text": "Social History"
},
"code": {
"text": "SHX Tobacco use"
},
"subject": {
"reference": "Patient/12724067"
},
"issued": "2019-12-26T19:25:58.000Z",
"valueCodeableConcept": {
"text": "Never (less than 100 in lifetime)"
}
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation/M197281704",
"resource": {
"resourceType": "Observation",
"id": "M197281704",
"meta": {
"versionId": "1-197281703",
"lastUpdated": "2020-03-13T16:29:54.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Observation</b></p><p><b>Patient</b>: 12724067</p><p><b>Status</b>: Final</p><p><b>Category</b>: Laboratory</p><p><b>Code</b>: Estimated Creatinine Clearance</p><p><b>Result</b>: 122.60 mL/min</p><p><b>Date</b>: Mar 13, 2020 4:29 P.M. UTC</p></div>"
},
"status": "final",
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "laboratory",
"display": "Laboratory"
}
],
"text": "Laboratory"
},
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2164-2"
}
],
"text": "Estimated Creatinine Clearance"
},
"subject": {
"reference": "Patient/12724067"
},
"encounter": {
"reference": "Encounter/97953480"
},
"effectiveDateTime": "2020-03-13T16:29:54.000Z",
"issued": "2020-03-13T16:29:54.000Z",
"valueQuantity": {
"value": 122.6,
"unit": "mL/min",
"system": "http://unitsofmeasure.org",
"code": "mL/min"
}
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation/BP-197198008-197198010",
"resource": {
"resourceType": "Observation",
"id": "BP-197198008-197198010",
"meta": {
"versionId": "1-197198007-1-197198009",
"lastUpdated": "2019-12-26T19:23:27.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Observation</b></p><p><b>Patient</b>: 12724067</p><p><b>Status</b>: Final</p><p><b>Category</b>: Vital Signs</p><p><b>Code</b>: Systolic Blood Pressure: Systolic Blood Pressure Diastolic Blood Pressure: Diastolic Blood Pressure</p><p><b>Result</b>: Systolic Blood Pressure: 138 mmHg Diastolic Blood Pressure: 90 mmHg</p><p><b>Risk Level</b>: Normal</p><p><b>Date</b>: Dec 26, 2019 7:23 P.M. UTC</p><p><b>Risk Level Detail</b>: Systolic Blood Pressure: 90-140 mmHg Diastolic Blood Pressure: 60-90 mmHg</p></div>"
},
"status": "final",
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "vital-signs",
"display": "Vital Signs"
}
],
"text": "Vital Signs"
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "75367002",
"display": "Blood pressure (observable entity)"
},
{
"system": "http://loinc.org",
"code": "55284-4"
}
],
"text": "Blood pressure"
},
"subject": {
"reference": "Patient/12724067"
},
"encounter": {
"reference": "Encounter/97939521"
},
"effectiveDateTime": "2019-12-26T19:23:00.000Z",
"issued": "2019-12-26T19:23:23.000Z",
"interpretation": {
"coding": [
{
"system": "http://hl7.org/fhir/v2/0078",
"code": "N",
"display": "Normal"
}
]
},
"component": [
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8480-6"
}
],
"text": "Systolic Blood Pressure"
},
"valueQuantity": {
"value": 138,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
},
"referenceRange": [
{
"low": {
"value": 90,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
},
"high": {
"value": 140,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
},
"text": "90-140 mmHg"
}
]
},
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8462-4"
},
{
"system": "http://loinc.org",
"code": "8462-4"
}
],
"text": "Diastolic Blood Pressure"
},
"valueQuantity": {
"value": 90,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
},
"referenceRange": [
{
"low": {
"value": 60,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
},
"high": {
"value": 90,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
},
"text": "60-90 mmHg"
}
]
}
]
}
},
{
"fullUrl": "https://fhir-open.cerner.com/dstu2/ec2458f2-1e24-41c8-b71b-0e701af7583d/Observation/M197198002",
"resource": {
"resourceType": "Observation",
"id": "M197198002",
"meta": {
"versionId": "1-197198001",
"lastUpdated": "2019-12-26T19:23:12.000Z"
},
"text": {
"status": "generated",
"div": "<div><p><b>Observation</b></p><p><b>Patient</b>: 12724067</p><p><b>Status</b>: Final</p><p><b>Category</b>: Vital Signs</p><p><b>Code</b>: Height/Length Measured</p><p><b>Result</b>: 180 cm</p><p><b>Date</b>: Dec 26, 2019 7:21 P.M. UTC</p></div>"
},
"status": "final",
"category": {
"coding": [
{
"system": "http://hl7.org/fhir/observation-category",
"code": "vital-signs",
"display": "Vital Signs"
}
],
"text": "Vital Signs"
},
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "3137-7"
}
],
"text": "Height/Length Measured"
},
"subject": {
"reference": "Patient/12724067"
},
"encounter": {
"reference": "Encounter/97939521"
},
"effectiveDateTime": "2019-12-26T19:21:00.000Z",
"issued": "2019-12-26T19:22:59.000Z",
"valueQuantity": {
"value": 180,
"unit": "cm",
"system": "http://unitsofmeasure.org",
"code": "cm"
}
}
}
]
}
Headers
-
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.