MaxIntegration V1.0 Documentation CCDS Support - Vital Signs

Vital Signs

In FHIR STU3 standard, Observation resource is designed as a type of event resource describing, measurements and simple assertions made about a patient, device or other subject. For vital signs, we are using this resource.

Using Observation resource defined in FHIR, CCDS element as Smoking Status and Vital Signs are concluded utilizing this resource.

Required or some important fields and parameters would be given in the following tables. Operations and parameters of this resource would also be listed.

Resource Element Fields

Name Description Type
identifier The identifier for this specific observation Identifier
status The status code code (ObservationStatus)
category Classification of type of observation CodeableConcept (Observation Category Codes)
code Type of observation CodeableConcept (LOINC Codes)
subject Who and/or what this is about Reference (Patient | Group | Device | Location)
effective Clinically relevant time/time-period for observation effectiveDateTime: dateTime, effectivePeriod: Period
value The result of the observation valueQuantity: Quantity
valueCodeableConcept: CodeableConcept
valueString: string
valueBoolean: boolean
valueRange: Range
valueRatio: Ratio
valueSampledData: SampledData
valueAttachment: Attachment
valueTime: time
valueDateTime: dateTime
valuePeriod: Period
referenceRange Provides guide for interpretation low: SimpleQuantity
high: SimpleQuantity
type: CodeableConcept (Observation Reference Range Meaning Codes)
appliesTo: CodeableConcept (Observation Reference Range Applies To Codes)
age: Range
text: string

Vital Signs

Get Vital Signs by Patient

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient={id}&category=http://hl7.org/fhir/observation-category|vital-signs

Example:

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient=232&category=http://hl7.org/fhir/observation-category|vital-signs
                {
    "resourceType": "Bundle",
    "id": "1cee4961-6268-4cc1-8f3b-f8c63bcf2fa4",
    "meta": {
        "lastUpdated": "2017-12-20T10:05:47.893-06:00"
    },
    "type": "searchset",
    "total": 9,
    "link": [
        {
            "relation": "self",
            "url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?category=http%3A%2F%2Fhl7.org%2Ffhir%2Fobservation-category%7Cvital-signs&patient=232"
        }
    ],
    "entry": [
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/265",
            "resource": {
                "resourceType": "Observation",
                "id": "265",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8867-4",
                            "display": "Heart Rate"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:10:00-04:00",
                "valueQuantity": {
                    "value": 80,
                    "unit": "/min"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/264",
            "resource": {
                "resourceType": "Observation",
                "id": "264",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8480-6",
                            "display": "Blood Pressure - Systolic"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:08:00-04:00",
                "valueQuantity": {
                    "value": 145,
                    "unit": "mm[Hg]"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/263",
            "resource": {
                "resourceType": "Observation",
                "id": "263",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8462-4",
                            "display": "Blood Pressure - Diastolic"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:08:00-04:00",
                "valueQuantity": {
                    "value": 88,
                    "unit": "mm[Hg]"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/262",
            "resource": {
                "resourceType": "Observation",
                "id": "262",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "29463-7",
                            "display": "Weight"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:05:00-04:00",
                "valueQuantity": {
                    "value": 88,
                    "unit": "kg"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/269",
            "resource": {
                "resourceType": "Observation",
                "id": "269",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "9279-1",
                            "display": "Respiratory Rate"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:15:00-04:00",
                "valueQuantity": {
                    "value": 18,
                    "unit": "/min"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/268",
            "resource": {
                "resourceType": "Observation",
                "id": "268",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8310-5",
                            "display": "Body Temperature"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:15:00-04:00",
                "valueQuantity": {
                    "value": 38,
                    "unit": "Cel"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/267",
            "resource": {
                "resourceType": "Observation",
                "id": "267",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "3150-0",
                            "display": "Inhaled Oxygen Concentration"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:12:00-04:00",
                "valueQuantity": {
                    "value": 36,
                    "unit": "%"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/266",
            "resource": {
                "resourceType": "Observation",
                "id": "266",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "59408-5",
                            "display": "O2 % BldC Oximetry"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:12:00-04:00",
                "valueQuantity": {
                    "value": 95,
                    "unit": "%"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/261",
            "resource": {
                "resourceType": "Observation",
                "id": "261",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8302-2",
                            "display": "Height"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:05:00-04:00",
                "valueQuantity": {
                    "value": 177,
                    "unit": "cm"
                }
            },
            "search": {
                "mode": "match"
            }
        }
    ]
}
                
    

Get Certain Type of Vital Sign

Here, all available parameter used is just the same as we would use in the previous category: Smoking Status, because they are basically derived from one resource called Observation.

A 'code' parameter is required to specify the type of the Vital Sign, height, for example. Its code is LOINC|8302-2;

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient={id}&category=http://hl7.org/fhir/observation-category|vital-signs&code={code}

Example:

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient=232&category=http://hl7.org/fhir/observation-category|vital-signs&code=LOINC|8302-2
        {
    "resourceType": "Bundle",
    "id": "10e1937a-e029-40ea-89e3-db98fd648633",
    "meta": {
        "lastUpdated": "2017-12-20T10:15:30.207-06:00"
    },
    "type": "searchset",
    "total": 1,
    "link": [
        {
            "relation": "self",
            "url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?category=http%3A%2F%2Fhl7.org%2Ffhir%2Fobservation-category%7Cvital-signs&code=LOINC%7C8302-2&patient=232"
        }
    ],
    "entry": [
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/261",
            "resource": {
                "resourceType": "Observation",
                "id": "261",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-15T15:18:36.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8302-2",
                            "display": "Height"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/232"
                },
                "context": {
                    "reference": "Encounter/243"
                },
                "effectiveDateTime": "2015-06-22T11:05:00-04:00",
                "valueQuantity": {
                    "value": 177,
                    "unit": "cm"
                }
            },
            "search": {
                "mode": "match"
            }
        }
    ]
}
        
    

Search Vital Signs on a Specific Date

The request format would be like:

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient={id}&category=http://hl7.org/fhir/observation-category|vital-signs&date={dateTime}

Example:

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient=66&category=http://hl7.org/fhir/observation-category|vital-signs&date=2015-07-22
        {
    "resourceType": "Bundle",
    "id": "db31af19-d2a4-4e29-9eb4-7c89a06bb03a",
    "meta": {
        "lastUpdated": "2017-12-20T10:21:51.978-06:00"
    },
    "type": "searchset",
    "total": 4,
    "link": [
        {
            "relation": "self",
            "url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?category=http%3A%2F%2Fhl7.org%2Ffhir%2Fobservation-category%7Cvital-signs&date=2015-07-22&patient=66"
        }
    ],
    "entry": [
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/80",
            "resource": {
                "resourceType": "Observation",
                "id": "80",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8480-6",
                            "display": "Blood Pressure - Systolic"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:10:00-04:00",
                "valueQuantity": {
                    "value": 145,
                    "unit": "mm[Hg]"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/78",
            "resource": {
                "resourceType": "Observation",
                "id": "78",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "29463-7",
                            "display": "Weight"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:05:00-04:00",
                "valueQuantity": {
                    "value": 88,
                    "unit": "kg"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/77",
            "resource": {
                "resourceType": "Observation",
                "id": "77",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8302-2",
                            "display": "Height"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:05:00-04:00",
                "valueQuantity": {
                    "value": 177,
                    "unit": "cm"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/79",
            "resource": {
                "resourceType": "Observation",
                "id": "79",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8462-4",
                            "display": "Blood Pressure - Diastolic"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:10:00-04:00",
                "valueQuantity": {
                    "value": 88,
                    "unit": "mm[Hg]"
                }
            },
            "search": {
                "mode": "match"
            }
        }
    ]
}
        
    

Search Vital Signs in a Range of Date

The request format would be like:

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient={id}&category=http://hl7.org/fhir/observation-category|vital-signs&date=>={dateTime}&date=<{dateTime (later than previous dateTime)}

Example:

GET https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?patient=66&category=http://hl7.org/fhir/observation-category|vital-signs&date=>=2015-07-21&date=<2015-08-31
        {
    "resourceType": "Bundle",
    "id": "0d3ff344-df39-477c-87bb-4f246aaa28f3",
    "meta": {
        "lastUpdated": "2017-12-20T10:29:00.113-06:00"
    },
    "type": "searchset",
    "total": 4,
    "link": [
        {
            "relation": "self",
            "url": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation?category=http%3A%2F%2Fhl7.org%2Ffhir%2Fobservation-category%7Cvital-signs&date=%3E%3D2015-07-21&date=%3C2015-08-31&patient=66"
        }
    ],
    "entry": [
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/80",
            "resource": {
                "resourceType": "Observation",
                "id": "80",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8480-6",
                            "display": "Blood Pressure - Systolic"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:10:00-04:00",
                "valueQuantity": {
                    "value": 145,
                    "unit": "mm[Hg]"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/78",
            "resource": {
                "resourceType": "Observation",
                "id": "78",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "29463-7",
                            "display": "Weight"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:05:00-04:00",
                "valueQuantity": {
                    "value": 88,
                    "unit": "kg"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/77",
            "resource": {
                "resourceType": "Observation",
                "id": "77",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8302-2",
                            "display": "Height"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:05:00-04:00",
                "valueQuantity": {
                    "value": 177,
                    "unit": "cm"
                }
            },
            "search": {
                "mode": "match"
            }
        },
        {
            "fullUrl": "https://evalfhir.directmdemail.com/fhir/baseDstu3/Observation/79",
            "resource": {
                "resourceType": "Observation",
                "id": "79",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2017-12-13T14:15:25.000-06:00"
                },
                "category": [
                    {
                        "coding": [
                            {
                                "system": "http://hl7.org/fhir/observation-category",
                                "code": "vital-signs",
                                "display": "Vital Signs"
                            }
                        ]
                    }
                ],
                "code": {
                    "coding": [
                        {
                            "system": "LOINC",
                            "code": "8462-4",
                            "display": "Blood Pressure - Diastolic"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/66"
                },
                "context": {
                    "reference": "Encounter/75"
                },
                "effectiveDateTime": "2015-07-22T15:10:00-04:00",
                "valueQuantity": {
                    "value": 88,
                    "unit": "mm[Hg]"
                }
            },
            "search": {
                "mode": "match"
            }
        }
    ]
}