> ## Documentation Index > Fetch the complete documentation index at: https://help.elationhealth.com/llms.txt > Use this file to discover all available pages before exploring further. # Smoking Status ## Overview Representing a patient’s smoking behavior through the core FHIR Observation Resource. The profile restricts observation code to be set in 72166-2 Tobacco smoking status NHIS (LOINC). Each Observation has next elements: * a status * a category code of ‘social-history’ * a code for smoking observation * a patient * a date representing when the smoking status was recorded * a result value code for smoking status **Profile specific implementation guidance:** This resource conforms to [USCDI V2 profile](https://www.healthit.gov/isa/united-states-core-data-interoperability-uscdi#uscdi-v2) for Observation - refer to [US Core Observation Profile](https://www.hl7.org/fhir/us/core/StructureDefinition-us-core-smokingstatus.html). Observation response will be provided in JSON (refers to Capability Statement) format as per [FHIR](https://hl7.org/fhir) standard R4 version. | USCore Data Element | FHIR Resource Field | | ---------------------------- | --------------------- | | status | Observation.status | | code | Observation.code | | patient | Observation.subject | | smoking status recorded date | Observation.effective | | value | Observation.value | ### Must support elements, mandatory and optional search parameters *Observation**must support** these elements:* * `status` * `Slices for category` * ` category:SocialHistory` * `code` * `subject` * `effectiveDateTime` * `valueCodeableConcept` The syntax used to describe the interactions is described [here](/articles/fhir/us-core-guidance). *The following search parameters and search parameter combinations SHALL be supported:* **SHALL** support searching for all Observation for a patient using the patient and code search parameters: * including optional support for OR search on code (e.g.code=\{system|}`[code]`,\{system|}`[code]`) `GET [base url]/Observation?patient={Type/}`\[id]`&code=http://loinc.org|72166-2` The response to any search operation is always a list of resources in a Bundle or an Operation Outcome. ## Observation By Patient Id Search for Observation by patient. **METHOD** *GET* ``` [base url]/Observation?patient={Type/}[id] ``` **PARAMS**\ \[base url] - [FHIR base url](/articles/fhir/service-base-urls)\ \[id] - Id for the Patient **HEADERS** The Authorization token SHALL be obtained during the Authentication and Authorization process. Go to [Authentication and Authorization](/articles/fhir/authentication-authorization) for further details. | Header | Type | Required/Optional | Value | | ------------- | ---------- | ----------------- | ---------------- | | Authorization | **string** | required | `Bearer ` | **RESPONSES** | Code | Description | Comment | | ---- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | 200 | OK | The request was processed successfully | | 400 | Bad request | Invalid request parameters or FHIR operation outcome resource returned | | 401 | Unauthorized | This code indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource | | 404 | No route matched with those values | The request was able to communicate with a given server, but the server could not find what was requested | | 500 | Internal Server Error | The server has encountered a situation it doesn't know how to handle | **EXAMPLE:** ``` curl --location --request GET 'https://sandbox.fhir.elationemr.com/fhir/Observation?patient=Patient/c5137fa5-3216-b12a-cbbc-a0c6bef361g7' \ --header 'Authorization: Bearer fe1cd986-1ac7-4c26-b8b3-d632a48408fd' ``` ## Observation By Id Get Observation by ID. **METHOD** *GET* ``` [base url]/Observation/{id} ``` or ``` [base url]/Observation?_id={id} ``` **PARAMS**\ \[base url] - [FHIR base url](/articles/fhir/service-base-urls)\ `{id}` - Id for Observation resource **HEADERS** The Authorization token SHALL be obtained during the Authentication and Authorization process. Go to [Authentication and Authorization](/articles/fhir/authentication-authorization) for further details. | Header | Type | Required/Optional | Value | | ------------- | ---------- | ----------------- | ---------------- | | Authorization | **string** | required | `Bearer ` | **RESPONSES** | Code | Description | Comment | | ---- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | 200 | OK | The request was processed successfully | | 400 | Bad request | Invalid request parameters or FHIR operation outcome resource returned | | 401 | Unauthorized | This code indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource | | 404 | No route matched with those values | The request was able to communicate with a given server, but the server could not find what was requested | | 500 | Internal Server Error | The server has encountered a situation it doesn't know how to handle | **EXAMPLE:** ``` curl --location --request GET 'https://sandbox.fhir.elationemr.com/fhir/Observation/c5137fa5-3216-b12a-cbbc-a0c6bef361g7' \ --header 'Authorization: Bearer fe1cd986-1ac7-4c26-b8b3-d632a48408fd' ``` ## Observation by patient and code Get Observations for the specified patient and code search parameters **METHOD** *GET* ``` GET [base url]/Observation?patient={Type/}[id]&code=http://loinc.org|72166-2 ``` **PARAMS**\ \[base url] - [FHIR base url](/articles/fhir/service-base-urls)\ \[id] - patient id\ `{Type/}` - Type for the Reference. *Example:* `Patient` **HEADERS** The Authorization token SHALL be obtained during the Authentication and Authorization process. Go to [Authentication and Authorization](/articles/fhir/authentication-authorization) for further details. | Header | Type | Required/Optional | Value | | ------------- | ---------- | ----------------- | ---------------- | | Authorization | **string** | required | `Bearer ` | **RESPONSES** | Code | Description | Comment | | ---- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | 200 | OK | The request was processed successfully | | 400 | Bad request | Invalid request parameters or FHIR operation outcome resource returned | | 401 | Unauthorized | This code indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource | | 404 | No route matched with those values | The request was able to communicate with a given server, but the server could not find what was requested | | 500 | Internal Server Error | The server has encountered a situation it doesn't know how to handle | **EXAMPLE:** ``` curl --location --request GET 'https://sandbox.fhir.elationemr.com/fhir/Observation?patient=Patient/fe1cd986-1ac7-4c26-b8b3-d632a48408fd&code=http://loinc.org|72166-2' \ --header 'Authorization: Bearer 1239b275-909e-4754-8f73-1e411fd6769e' ```