Smoking Status

Smoking Status reference the observation profile, which contains measurements and simple assertions made about a patient, device or other subject.

Definition

Observation Resource

References

Get/Read

The [patient|user|system]/Observation.r authorization scope is required.

Required Parameters

Name Description DataType
ID The id for the Observation Resource. Token

Result Components

Name Description
Observation.Status Code
Observation.Category | Observation.Category:SocialHistory CodeableConcept
Observation.Code Code
Observation.subject Reference
Observation.effective DateTime
Observation.value[x]:valueCodeableConcept CodeableConcept

Response Codes

Response Code Description
200 OK The requested Observation resource was found and is contained within the body of the HTTP response.
400 Bad Request The server could not understand the request due to invalid syntax.
404 Not Found The requested resource does not exist.
500 Internal Server Error The server has encountered a situation it doesn't know how to handle, resulting in an error.

Example GET syntax of Observation ResourceID: 12980SocHX:

GET https://webservices.systemedx.com/xnet/api/fhir/Observation/12980SocHX

This would return a Resource like the one below.

{
    "resourceType": "Observation",
    "id": "12980SocHX",
    "status": "final",
    "category": [
        {
            "coding": [
                {
                    "system": "http://terminology.hl7.org/CodeSystem/observation-category",
                    "code": "social-history"
                }
            ]
        }
    ],
    "code": {
        "coding": [
            {
                "system": "http://loinc.org",
                "code": "72166-2",
                "display": "Tobacco smoking status"
            }
        ]
    },
    "subject": {
        "reference": "https://webservices.systemedx.com/xnet/api/fhir/Patient/66"
    },
    "effectiveDateTime": "2022-02-11T00:00:00-06:00",
    "valueCodeableConcept": {
        "coding": [
            {
                "system": "http://snomed.info/sct",
                "code": "428041000124106",
                "display": "Current some day smoker"
            }
        ]
    }
}

Search/Post

The [patient|user|system]/Observation.rs authorization scope is required.

The following additional authorization scopes might be required depending on _revinclude search parameters used:

Required & Optional Parameters

Name Description DataType
patient The subject that the observation is about (if patient) Reference
code The code of the observation type Token

Example SEARCH syntax of Observation for Patientid 66 smoking status Observations:

GET https://webservices.systemedx.com/xnet/api/fhir/Observation?patient=66&code=http://loinc.org|72166-2

This would return a bundle containing one or more Observation Resources like the one above.