Encounter

Overview

The Encounter resource provides admissions or visits during which health care services were provided to a patient. An encounter has a class to distinguish between different health care settings such as inpatient, outpatient, emergency, etc. A patient may have one medical record number with multiple encounter numbers per facility or organization. There is substantial variance between organizations in the definition of an encounter and what events are aggregated together to constitute an encounter.

The following fields are returned if valued:

Contained Location Bindings

Location.type
  • Description
    • Indicates the type of function performed at the location.
  • Details: v3 Code System RoleCode
    System: http://terminology.hl7.org/CodeSystem/v3-RoleCode

Terminology Bindings

Encounter.identifier.type
  • Description
    • The type used to determine which identifier to use for a specific purpose.
  • Details: Identifier Type Codes
    System: http://hl7.org/fhir/identifier-type

  • Details: v2 Identifier Type
    System: http://terminology.hl7.org/CodeSystem/v2-0203

  • Details: Millennium Encounter AliasType
    System: https://fhir.cerner.com/<EHR source id>/codeSet/319

Encounter.type
  • Description
    • The type of encounter.
  • Note
    • Encounters created with meta.security set with code 'UNCERTREL' will be returned with an external encounter type.
  • Details: Millennium Encounter Visit Type
    System: https://fhir.cerner.com/<EHR source id>/codeSet/71

  • Details: v2 Patient Class
    System: http://terminology.hl7.org/CodeSystem/v2-0004

  • Details: SNOMED CT
    System: http://snomed.info/sct

Encounter.serviceType
Encounter.priority
Encounter.participant.type
Encounter.hospitalization.admitSource
Encounter.hospitalization.dietPreference
  • Description
    • Medical, cultural or ethical food preferences to help with catering requirements.
  • Details: Diet
    System: http://terminology.hl7.org/CodeSystem/diet

  • Details: Millennium Patient Diet Preference
    System: https://fhir.cerner.com/<EHR source id>/codeSet/18

Encounter.hospitalization.specialCourtesy
Encounter.hospitalization.specialArrangement
  • Description
    • Special arrangements.
  • Details: SpecialArrangements
    System: http://hl7.org/fhir/encounter-special-arrangements

Encounter.hospitalization.dischargeDisposition
Encounter.meta.security
  • Description
    • Security labels applied to this resource.
  • Note
    • Encounters created with meta.security set with code 'UNCERTREL' will be returned with an external encounter type.
  • Details: Observation Values
    System: http://terminology.hl7.org/CodeSystem/v3-ObservationValue

Encounter.extension[x].extension[x].valueCodeableConcept
  • Description
    • The value of the client defined custom attribute. This binding is used for the custom-attribute-value extension nested under custom-attribute extensions.
  • Note
      • The terminology binding only applies when the custom-attribute-value extension is of type CodeableConcept.
      • The value of the custom attribute is not limited to a single Code Set or nomenclature.
  • Details: Custom Attribute Code Value
    System: https://fhir.cerner.com/<EHR source id>/codeSet/<code set>

  • Details: Custom Attribute Nomenclature Value
    System: https://fhir.cerner.com/<EHR source id>/nomenclature

Encounter.extension[x].valueMoney.currency
  • Description
    • Currency codes from [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). This binding is used in estimated-financial-responsibility-amount extensions.
  • Details: Currencies
    System: urn:iso:std:iso:4217

Encounter.extension[x].valueCodeableConcept
  • Description
    • The reason no estimated amount is collected for the encounter. This binding is used in estimated-financial-responsibility-not-collected-reason extensions.
  • Details: Estimated Financial Responsibility Not Collected Reason
    System: https://fhir.cerner.com/<EHR source id>/codeSet/4660008

Encounter.extension[x].valueCodeableConcept
  • Description
    • Identifies whether an encounter is connected to military service. This binding is used in military-service-connected-indicator extensions.
  • Details: Military Service Connected Indicator
    System: https://fhir.cerner.com/<EHR source id>/codeSet/4003348

Encounter.extension[x].valueCodeableConcept
  • Description
    • The payment collection status. This binding is used in payment-collection-status extensions.
  • Details: Payment Collection Status
    System: https://fhir.cerner.com/<EHR source id>/codeSet/4003489

Extensions

Custom Extensions

All URLs for custom extensions are defined as https://fhir-ehr.cerner.com/r4/StructureDefinition/{id}

ID Value[x] Type Description
client-organization Reference The financially responsible organization.
custom-attribute None (contains nested extensions) A client defined custom attribute for the resource. Attribute values can be of type integer, string, CodeableConcept, or dateTime.
estimated-financial-responsibility-amount Money The estimated amount to be collected for the encounter.
estimated-financial-responsibility-not-collected-reason CodeableConcept The reason no estimated amount is collected for the encounter.
military-service-connected-indicator CodeableConcept Identifies whether an encounter is connected to military service.
payment-collection-status CodeableConcept The status of the payment collection for the encounter.

Search for Encounters that meet supplied query parameters:

GET /Encounter?:parameters

Implementation Notes

Authorization Types

Parameters

Name Required? Type Description
_id This or patient or subject or account or identifier or pageContext token The logical resource id associated with the Encounter. Example: 7891
patient This or subject or account or _id or identifier or pageContext reference The patient present at the encounter. Example: 12345
subject This or patient or account or _id or identifier or pageContext reference The patient present at the encounter. Example: subject=Patient/12345 or subject:Patient=12345
account This or patient or subject or _id or identifier or pageContext reference The account associated with the encounters. Example: F703726
identifier This or patient or subject or account or _id or pageContext token An encounter’s identifier. Example: urn:oid:1.2.243.58|110219457
date No dateTime Datetime range into which the encounter’s period datetime falls. Must be prefixed by ‘ge’, ‘gt’, ‘le’ or ‘lt’.
_count No number The maximum number of results to return.
status No token The status of the encounter. Example: planned
_revinclude No token Provenance resource entries to be returned as part of the bundle. Example:_revinclude=Provenance:target

Notes:

Headers

Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?patient=12724066

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "22bae7f5-5275-477a-aebf-8ba8cebbf0b8",
  "type": "searchset",
  "total": 2,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?patient=12724066"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97939518",
      "resource": {
        "resourceType": "Encounter",
        "id": "97939518",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2020-10-02T00:08:17.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Hospital, MX Hospital, NU05, 102, A</p><p><b>Type</b>: Inpatient</p><p><b>Service Type</b>: Medicine-General</p><p><b>Class</b>: inpatient encounter</p><p><b>Status</b>: Finished</p><p><b>Period Start Date</b>: Dec 26, 2019  3:38 P.M. UTC</p><p><b>Period End Date</b>: Jan  7, 2020  6:00 A.M. UTC</p><p><b>Reason For Visit</b>: Illness</p><p><b>Attending Physician</b>: Cerner Test, Physician - Hospitalist Cerner</p></div>"
        },
        "extension": [
          {
            "extension": [
              {
                "id": "ENCNTR:17368048",
                "valueString": "Full Reg Date/Time",
                "url": "custom-attribute-name"
              },
              {
                "valueDateTime": "2019-12-26T15:41:52.000Z",
                "url": "custom-attribute-value"
              }
            ],
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
          },
          {
            "extension": [
              {
                "id": "ENCNTR:2572582103",
                "valueString": "Driving Dx",
                "url": "custom-attribute-name"
              },
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/nomenclature",
                      "code": "13249728",
                      "display": "Primary stabbing headache",
                      "userSelected": false
                    }
                  ],
                  "text": "Primary stabbing headache"
                },
                "url": "custom-attribute-value"
              }
            ],
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
          },
          {
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/estimated-financial-responsibility-amount",
            "valueMoney": {
              "value": 0.0,
              "currency": "USD"
            }
          }
        ],
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "_system": {
              "extension": [
                {
                  "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
                  "valueCode": "unknown"
                }
              ]
            },
            "value": "15951",
            "period": {
              "start": "2019-12-26T15:41:55.000Z"
            }
          }
        ],
        "status": "finished",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
          "code": "IMP",
          "display": "inpatient encounter",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309308",
                "display": "Inpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "I",
                "display": "Inpatient",
                "userSelected": false
              }
            ],
            "text": "Inpatient"
          }
        ],
        "serviceType": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/34",
              "code": "313012",
              "display": "Medicine-General",
              "userSelected": true
            },
            {
              "system": "http://snomed.info/sct",
              "code": "700232004",
              "display": "General medical service (qualifier value)",
              "userSelected": false
            }
          ],
          "text": "Medicine-General"
        },
        "priority": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/3",
              "code": "670840",
              "display": "Elective",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActPriority",
              "code": "EL",
              "display": "elective",
              "userSelected": false
            }
          ],
          "text": "Elective"
        },
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "participant": [
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "1119",
                    "display": "Attending Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "ATND",
                    "display": "attender",
                    "userSelected": false
                  }
                ],
                "text": "Attending Physician"
              }
            ],
            "period": {
              "start": "2019-12-26T15:41:55.000Z"
            },
            "individual": {
              "reference": "Practitioner/4122622",
              "display": "Cerner Test, Physician - Hospitalist Cerner"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "1121",
                    "display": "Consulting Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "CON",
                    "display": "consultant",
                    "userSelected": false
                  }
                ],
                "text": "Consulting Physician"
              }
            ],
            "period": {
              "start": "2020-04-30T17:47:00.000Z",
              "end": "2020-04-30T18:01:18.000Z"
            },
            "individual": {
              "reference": "Practitioner/12732065",
              "display": "PWDiabetesMe, Physician - Hospitalist"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "1121",
                    "display": "Consulting Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "CON",
                    "display": "consultant",
                    "userSelected": false
                  }
                ],
                "text": "Consulting Physician"
              }
            ],
            "period": {
              "start": "2020-04-24T18:27:00.000Z",
              "end": "2020-04-24T19:01:26.000Z"
            },
            "individual": {
              "reference": "Practitioner/12732065",
              "display": "PWDiabetesMe, Physician - Hospitalist"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "1126",
                    "display": "Referring Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "REF",
                    "display": "referrer",
                    "userSelected": false
                  }
                ],
                "text": "Referring Physician"
              }
            ],
            "period": {
              "start": "2019-12-26T15:41:55.000Z"
            },
            "individual": {
              "reference": "Practitioner/4122622",
              "display": "Cerner Test, Physician - Hospitalist Cerner"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-01-31T20:34:00.000Z",
              "end": "2020-01-31T21:01:21.000Z"
            },
            "individual": {
              "reference": "Practitioner/12732065",
              "display": "PWDiabetesMe, Physician - Hospitalist"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2019-12-26T19:05:12.000Z",
              "end": "2020-01-17T06:01:53.000Z"
            },
            "individual": {
              "reference": "Practitioner/12724045",
              "display": "Graham, Joshua"
            }
          }
        ],
        "appointment": [
          {
            "reference": "Appointment/4818609"
          }
        ],
        "period": {
          "start": "2019-12-26T15:38:02.000Z",
          "end": "2020-01-07T06:00:00.000Z"
        },
        "reasonCode": [
          {
            "text": "Illness"
          },
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/nomenclature",
                "code": "111611746",
                "display": "Illness",
                "userSelected": true
              }
            ],
            "text": "Illness"
          }
        ],
        "hospitalization": {
          "admitSource": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/2",
                "code": "4326381",
                "display": "Self (Non-HC Facility Source of Origin)",
                "userSelected": true
              }
            ],
            "text": "Self (Non-HC Facility Source of Origin)"
          }
        },
        "location": [
          {
            "location": {
              "reference": "Location/32545019",
              "display": "Model Hospital, MX Hospital, NU05, 102, A"
            },
            "status": "completed"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/675844"
        }
      }
    },
    {
      "fullUrl": "https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97939539",
      "resource": {
        "resourceType": "Encounter",
        "id": "97939539",
        "meta": {
          "versionId": "1",
          "lastUpdated": "2020-01-02T14:01:42.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Clinic 1, MX Clinic 1, MX Clinic 1</p><p><b>Type</b>: Outpatient</p><p><b>Service Type</b>: Cardiology</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: Finished</p><p><b>Period Start Date</b>: Dec 26, 2019  4:31 P.M. UTC</p><p><b>Period End Date</b>: Dec 27, 2019  5:59 A.M. UTC</p><p><b>Reason For Visit</b>: Illness</p><p><b>Attending Physician</b>: Cerner Test, Physician - Cardiovascular Cerner</p></div>"
        },
        "extension": [
          {
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/estimated-financial-responsibility-amount",
            "valueMoney": {
              "value": 0.0,
              "currency": "USD"
            }
          }
        ],
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "_system": {
              "extension": [
                {
                  "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
                  "valueCode": "unknown"
                }
              ]
            },
            "value": "15958",
            "period": {
              "start": "2019-12-26T16:33:21.000Z"
            }
          }
        ],
        "status": "finished",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "serviceType": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/34",
              "code": "33536475",
              "display": "Cardiology",
              "userSelected": true
            },
            {
              "system": "http://snomed.info/sct",
              "code": "3471000175103",
              "display": "Cardiology service (qualifier value)",
              "userSelected": false
            }
          ],
          "text": "Cardiology"
        },
        "priority": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/3",
              "code": "670840",
              "display": "Elective",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActPriority",
              "code": "EL",
              "display": "elective",
              "userSelected": false
            }
          ],
          "text": "Elective"
        },
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "participant": [
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "1119",
                    "display": "Attending Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "ATND",
                    "display": "attender",
                    "userSelected": false
                  }
                ],
                "text": "Attending Physician"
              }
            ],
            "period": {
              "start": "2019-12-26T16:33:21.000Z"
            },
            "individual": {
              "reference": "Practitioner/4122625",
              "display": "Cerner Test, Physician - Cardiovascular Cerner"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "1126",
                    "display": "Referring Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "REF",
                    "display": "referrer",
                    "userSelected": false
                  }
                ],
                "text": "Referring Physician"
              }
            ],
            "period": {
              "start": "2019-12-26T16:33:21.000Z"
            },
            "individual": {
              "reference": "Practitioner/4122625",
              "display": "Cerner Test, Physician - Cardiovascular Cerner"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "681274",
                    "display": "Database Coordinator",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PART",
                    "display": "Participation",
                    "userSelected": false
                  }
                ],
                "text": "Database Coordinator"
              }
            ],
            "period": {
              "start": "2020-07-06T19:20:00.000Z",
              "end": "2020-07-07T08:01:33.000Z"
            },
            "individual": {
              "reference": "Practitioner/12724064",
              "display": "Spence, Open Platform IA, Stephen"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-19T19:07:55.000Z",
              "end": "2020-05-19T20:01:41.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-19T17:58:00.000Z",
              "end": "2020-05-19T18:02:00.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-18T20:35:00.000Z",
              "end": "2020-05-18T21:01:50.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-18T15:25:00.000Z",
              "end": "2020-05-18T16:01:14.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-18T14:26:00.000Z",
              "end": "2020-05-18T15:01:19.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-16T16:24:00.000Z",
              "end": "2020-05-16T17:01:05.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-16T15:47:00.000Z",
              "end": "2020-05-16T16:01:39.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-15T17:39:00.000Z",
              "end": "2020-05-15T18:01:29.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-15T14:51:00.000Z",
              "end": "2020-05-15T15:01:44.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-14T23:06:37.000Z",
              "end": "2020-05-15T00:01:56.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-14T22:53:00.000Z",
              "end": "2020-05-14T23:02:00.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-14T20:38:00.000Z",
              "end": "2020-05-14T21:01:11.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          },
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "18883355",
                    "display": "Covering Physician",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PPRF",
                    "display": "primary performer",
                    "userSelected": false
                  }
                ],
                "text": "Covering Physician"
              }
            ],
            "period": {
              "start": "2020-05-14T18:03:28.000Z",
              "end": "2020-05-14T19:01:24.000Z"
            },
            "individual": {
              "reference": "Practitioner/12742575",
              "display": "Torres, Drew"
            }
          }
        ],
        "period": {
          "start": "2019-12-26T16:31:51.000Z",
          "end": "2019-12-27T05:59:59.000Z"
        },
        "reasonCode": [
          {
            "text": "Illness"
          }
        ],
        "hospitalization": {
          "admitSource": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/2",
                "code": "309200",
                "display": "Information Not Available",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/admit-source",
                "code": "other",
                "display": "Other",
                "userSelected": false
              }
            ],
            "text": "Information Not Available"
          },
          "dischargeDisposition": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/19",
                "code": "638671",
                "display": "Home or Self Care",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/discharge-disposition",
                "code": "home",
                "display": "Home",
                "userSelected": false
              }
            ],
            "text": "Home or Self Care"
          }
        },
        "location": [
          {
            "location": {
              "reference": "Location/21304876",
              "display": "Model Clinic 1, MX Clinic 1, MX Clinic 1"
            },
            "status": "completed"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/685844"
        }
      }
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Example with RevInclude

Authorization Types

Request

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?_id=1361920&_revinclude=Provenance:target #### Response
Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "ee084347-903b-494f-be58-640f1cc11ac7",
  "type": "searchset",
  "total": 1,
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?_id=1361920&_revinclude=Provenance%3Atarget"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/1361920",
      "resource": {
        "resourceType": "Encounter",
        "id": "1361920",
        "meta": {
          "versionId": "3",
          "lastUpdated": "1902-01-02T06:01:02.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: CONNOR, JOHN</p><p><b>Location</b>: Baseline West Primary Care Clinic, BW Clinic, BW Clinic</p><p><b>Type</b>: Clinic</p><p><b>Service Type</b>: Medicine-General</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: Finished</p><p><b>Period Start Date</b>: Jan 23, 2013  2:00 P.M. CST</p><p><b>Period End Date</b>: Jan 23, 2013  7:00 A.M. CST</p><p><b>Reason For Visit</b>: annual</p><p><b>Service Provider</b>: Baseline West Primary Care Clinic</p></div>"
        },
        "extension": [
          {
            "extension": [
              {
                "id": "ENCNTR:3339151",
                "valueString": "Previous Patient Type",
                "url": "custom-attribute-name"
              },
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                      "code": "22282402",
                      "display": "Clinic",
                      "userSelected": true
                    }
                  ],
                  "text": "Clinic"
                },
                "url": "custom-attribute-value"
              }
            ],
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
          },
          {
            "extension": [
              {
                "id": "ENCNTR:17368048",
                "valueString": "Full Reg Date/Time",
                "url": "custom-attribute-name"
              },
              {
                "valueDateTime": "2013-08-05T18:14:37.000Z",
                "url": "custom-attribute-value"
              }
            ],
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
          },
          {
            "extension": [
              {
                "id": "ENCNTR:4047481",
                "valueString": "Conversation",
                "url": "custom-attribute-name"
              },
              {
                "valueCodeableConcept": {
                  "coding": [
                    {
                      "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/100040",
                      "code": "4630114",
                      "display": "Register Patient",
                      "userSelected": true
                    }
                  ],
                  "text": "Register Patient"
                },
                "url": "custom-attribute-value"
              }
            ],
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
          },
          {
            "valueReference": {
              "reference": "Organization/589723"
            },
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/client-organization"
          }
        ],
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:1.2.243.58",
            "value": "110219457",
            "period": {
              "start": "2013-03-01T04:57:37.000Z"
            }
          }
        ],
        "status": "finished",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "22282402",
                "display": "Clinic",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Clinic"
          }
        ],
        "serviceType": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/34",
              "code": "313012",
              "display": "Medicine-General",
              "userSelected": true
            },
            {
              "system": "http://snomed.info/sct",
              "code": "700232004",
              "display": "General medical service (qualifier value)",
              "userSelected": false
            }
          ],
          "text": "Medicine-General"
        },
        "priority": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/3",
              "code": "309205",
              "display": "Routine",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ActPriority",
              "code": "R",
              "display": "routine",
              "userSelected": false
            }
          ],
          "text": "Routine"
        },
        "subject": {
          "reference": "Patient/1349960",
          "display": "CONNOR, JOHN"
        },
        "period": {
          "start": "2013-01-23T20:00:00.000Z",
          "end": "2013-01-23T13:00:00.000Z"
        },
        "reasonCode": [
          {
            "text": "annual"
          }
        ],
        "hospitalization": {
          "admitSource": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/2",
                "code": "309191",
                "display": "Clinic or Physician Office Referral",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/admit-source",
                "code": "gp",
                "display": "General Practitioner referral",
                "userSelected": false
              }
            ],
            "text": "Clinic or Physician Office Referral"
          },
          "dischargeDisposition": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/19",
                "code": "638671",
                "display": "Home or Self Care",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/discharge-disposition",
                "code": "home",
                "display": "Home",
                "userSelected": false
              }
            ],
            "text": "Home or Self Care"
          }
        },
        "location": [
          {
            "location": {
              "reference": "Location/20573082",
              "display": "Baseline West Primary Care Clinic, BW Clinic, BW Clinic"
            },
            "status": "completed"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/667844",
          "display": "Baseline West Primary Care Clinic"
        }
      },
      "search": {
        "mode": "match"
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/encntr-12606691",
      "resource": {
        "resourceType": "Provenance",
        "id": "encntr-12606691",
        "meta": {
          "versionId": "12606691",
          "lastUpdated": "2021-05-17T07:25:58-05:00"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Provenance</b></p><p><b>Target</b>:</p><ul><li>Encounter/1361920</li></ul><p><b>Recorded</b>: Oct 25, 2019  9:57 A.M. CDT</p><p><b>Agents</b>:</p><dl><dt>Unknown</dt><dd><b>Agent Type</b>: Transmitter</dd><dd><b>Agent Role</b>: Source</dd></dl><p><b>Entity Source</b>: DocumentReference/17255835</p></div>"
        },
        "target": [
          {
            "reference": "Encounter/1361920"
          }
        ],
        "recorded": "2019-10-25T09:57:43-05:00",
        "agent": [
          {
            "type": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type",
                  "code": "transmitter"
                }
              ],
              "text": "Transmitter"
            },
            "role": [
              {
                "coding": [
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
                    "code": "SOURCE"
                  }
                ],
                "text": "Source"
              }
            ],
            "who": {
              "reference": "Organization/619848",
              "display": "Unknown"
            }
          }
        ],
        "entity": [
          {
            "role": "source",
            "what": {
              "reference": "DocumentReference/17255835"
            }
          }
        ]
      },
      "search": {
        "mode": "include"
      }
    }
  ]
}

Patient Authorization Request

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?patient=12724066

Response

Status: 200 OK
{
  "resourceType": "Bundle",
  "id": "8fbab4cb-bf96-46cd-8dd4-e9acf616e3ae",
  "type": "searchset",
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?patient=12724066"
    },
    {
      "relation": "next",
      "url": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter?patient=12724066&-pageContext=51709352-6ee2-4d09-be3b-23dcc3fcc1eb&-pageDirection=NEXT"
    }
  ],
  "entry": [
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954225",
      "resource": {
        "resourceType": "Encounter",
        "id": "97954225",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2020-08-04T12:37:34.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Behavioral Health Hospital</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:5.5.5.5.5.5.",
            "value": "16131",
            "period": {
              "start": "2020-08-04T12:37:34.000Z"
            }
          }
        ],
        "status": "in-progress",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "participant": [
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                    "code": "242348525",
                    "display": "Chart Review",
                    "userSelected": true
                  },
                  {
                    "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
                    "code": "PART",
                    "display": "Participation",
                    "userSelected": false
                  }
                ],
                "text": "Chart Review"
              }
            ],
            "period": {
              "start": "2020-11-24T18:16:18.000Z"
            },
            "individual": {
              "reference": "Practitioner/12746397",
              "display": "Pwuptodate, RN"
            }
          }
        ],
        "location": [
          {
            "location": {
              "reference": "Location/31098367",
              "display": "Model Behavioral Health Hospital"
            },
            "status": "active"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/1054423"
        }
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954261",
      "resource": {
        "resourceType": "Encounter",
        "id": "97954261",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2020-08-06T14:42:26.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Behavioral Health Hospital</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:5.5.5.5.5.5.",
            "value": "16132",
            "period": {
              "start": "2020-08-06T14:42:26.000Z"
            }
          }
        ],
        "status": "in-progress",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "location": [
          {
            "location": {
              "reference": "Location/31098367",
              "display": "Model Behavioral Health Hospital"
            },
            "status": "active"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/1054423"
        }
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954262",
      "resource": {
        "resourceType": "Encounter",
        "id": "97954262",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2020-08-06T15:21:28.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Behavioral Health Hospital</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:5.5.5.5.5.5.",
            "value": "16133",
            "period": {
              "start": "2020-08-06T15:21:28.000Z"
            }
          }
        ],
        "status": "in-progress",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "location": [
          {
            "location": {
              "reference": "Location/31098367",
              "display": "Model Behavioral Health Hospital"
            },
            "status": "active"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/1054423"
        }
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954294",
      "resource": {
        "resourceType": "Encounter",
        "id": "97954294",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2020-08-10T15:49:27.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Clinic 1</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:5.5.5.5.5.5.",
            "value": "16135",
            "period": {
              "start": "2020-08-10T15:49:27.000Z"
            }
          }
        ],
        "status": "in-progress",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "location": [
          {
            "location": {
              "reference": "Location/21304872",
              "display": "Model Clinic 1"
            },
            "status": "active"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/685844"
        }
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954295",
      "resource": {
        "resourceType": "Encounter",
        "id": "97954295",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2020-08-10T16:20:20.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Clinic 1</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:5.5.5.5.5.5.",
            "value": "16136",
            "period": {
              "start": "2020-08-10T16:20:20.000Z"
            }
          }
        ],
        "status": "in-progress",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "location": [
          {
            "location": {
              "reference": "Location/21304872",
              "display": "Model Clinic 1"
            },
            "status": "active"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/685844"
        }
      }
    },
    {
      "fullUrl": "https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954406",
      "resource": {
        "resourceType": "Encounter",
        "id": "97954406",
        "meta": {
          "versionId": "0",
          "lastUpdated": "2020-08-18T16:45:49.000Z"
        },
        "text": {
          "status": "generated",
          "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Clinic 1</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
        },
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR",
                  "userSelected": true
                },
                {
                  "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                  "code": "AN",
                  "display": "Account number",
                  "userSelected": false
                }
              ],
              "text": "FIN NBR"
            },
            "system": "urn:oid:5.5.5.5.5.5.",
            "value": "16148",
            "period": {
              "start": "2020-08-18T16:45:49.000Z"
            }
          }
        ],
        "status": "in-progress",
        "class": {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        },
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309309",
                "display": "Outpatient",
                "userSelected": true
              },
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O",
                "display": "Outpatient",
                "userSelected": false
              }
            ],
            "text": "Outpatient"
          }
        ],
        "subject": {
          "reference": "Patient/12724066",
          "display": "SMART, NANCY"
        },
        "location": [
          {
            "location": {
              "reference": "Location/21304872",
              "display": "Model Clinic 1"
            },
            "status": "active"
          }
        ],
        "serviceProvider": {
          "reference": "Organization/685844"
        }
      }
    }
  ]
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Retrieve by id

List an individual Encounter by its id:

GET /Encounter/:id

Implementation Notes

Authorization Types

Headers

Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>

Example

Request

GET https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97939518

Response

Status: 200 OK
{
  "resourceType": "Encounter",
  "id": "97939518",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2020-10-02T00:08:17.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Hospital, MX Hospital, NU05, 102, A</p><p><b>Type</b>: Inpatient</p><p><b>Service Type</b>: Medicine-General</p><p><b>Class</b>: inpatient encounter</p><p><b>Status</b>: Finished</p><p><b>Period Start Date</b>: Dec 26, 2019  3:38 P.M. UTC</p><p><b>Period End Date</b>: Jan  7, 2020  6:00 A.M. UTC</p><p><b>Reason For Visit</b>: Illness</p><p><b>Attending Physician</b>: Cerner Test, Physician - Hospitalist Cerner</p></div>"
  },
  "extension": [
    {
      "extension": [
        {
          "id": "ENCNTR:17368048",
          "valueString": "Full Reg Date/Time",
          "url": "custom-attribute-name"
        },
        {
          "valueDateTime": "2019-12-26T15:41:52.000Z",
          "url": "custom-attribute-value"
        }
      ],
      "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
    },
    {
      "extension": [
        {
          "id": "ENCNTR:2572582103",
          "valueString": "Driving Dx",
          "url": "custom-attribute-name"
        },
        {
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/nomenclature",
                "code": "13249728",
                "display": "Primary stabbing headache",
                "userSelected": false
              }
            ],
            "text": "Primary stabbing headache"
          },
          "url": "custom-attribute-value"
        }
      ],
      "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/custom-attribute"
    },
    {
      "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/estimated-financial-responsibility-amount",
      "valueMoney": {
        "value": 0.0,
        "currency": "USD"
      }
    }
  ],
  "identifier": [
    {
      "use": "usual",
      "type": {
        "coding": [
          {
            "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
            "code": "1077",
            "display": "FIN NBR",
            "userSelected": true
          },
          {
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "code": "AN",
            "display": "Account number",
            "userSelected": false
          }
        ],
        "text": "FIN NBR"
      },
      "_system": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
            "valueCode": "unknown"
          }
        ]
      },
      "value": "15951",
      "period": {
        "start": "2019-12-26T15:41:55.000Z"
      }
    }
  ],
  "status": "finished",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
    "code": "IMP",
    "display": "inpatient encounter",
    "userSelected": false
  },
  "type": [
    {
      "coding": [
        {
          "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
          "code": "309308",
          "display": "Inpatient",
          "userSelected": true
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "I",
          "display": "Inpatient",
          "userSelected": false
        }
      ],
      "text": "Inpatient"
    }
  ],
  "serviceType": {
    "coding": [
      {
        "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/34",
        "code": "313012",
        "display": "Medicine-General",
        "userSelected": true
      },
      {
        "system": "http://snomed.info/sct",
        "code": "700232004",
        "display": "General medical service (qualifier value)",
        "userSelected": false
      }
    ],
    "text": "Medicine-General"
  },
  "priority": {
    "coding": [
      {
        "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/3",
        "code": "670840",
        "display": "Elective",
        "userSelected": true
      },
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ActPriority",
        "code": "EL",
        "display": "elective",
        "userSelected": false
      }
    ],
    "text": "Elective"
  },
  "subject": {
    "reference": "Patient/12724066",
    "display": "SMART, NANCY"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "1119",
              "display": "Attending Physician",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "ATND",
              "display": "attender",
              "userSelected": false
            }
          ],
          "text": "Attending Physician"
        }
      ],
      "period": {
        "start": "2019-12-26T15:41:55.000Z"
      },
      "individual": {
        "reference": "Practitioner/4122622",
        "display": "Cerner Test, Physician - Hospitalist Cerner"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "1121",
              "display": "Consulting Physician",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "CON",
              "display": "consultant",
              "userSelected": false
            }
          ],
          "text": "Consulting Physician"
        }
      ],
      "period": {
        "start": "2020-04-30T17:47:00.000Z",
        "end": "2020-04-30T18:01:18.000Z"
      },
      "individual": {
        "reference": "Practitioner/12732065",
        "display": "PWDiabetesMe, Physician - Hospitalist"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "1121",
              "display": "Consulting Physician",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "CON",
              "display": "consultant",
              "userSelected": false
            }
          ],
          "text": "Consulting Physician"
        }
      ],
      "period": {
        "start": "2020-04-24T18:27:00.000Z",
        "end": "2020-04-24T19:01:26.000Z"
      },
      "individual": {
        "reference": "Practitioner/12732065",
        "display": "PWDiabetesMe, Physician - Hospitalist"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "1126",
              "display": "Referring Physician",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "REF",
              "display": "referrer",
              "userSelected": false
            }
          ],
          "text": "Referring Physician"
        }
      ],
      "period": {
        "start": "2019-12-26T15:41:55.000Z"
      },
      "individual": {
        "reference": "Practitioner/4122622",
        "display": "Cerner Test, Physician - Hospitalist Cerner"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "18883355",
              "display": "Covering Physician",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "PPRF",
              "display": "primary performer",
              "userSelected": false
            }
          ],
          "text": "Covering Physician"
        }
      ],
      "period": {
        "start": "2020-01-31T20:34:00.000Z",
        "end": "2020-01-31T21:01:21.000Z"
      },
      "individual": {
        "reference": "Practitioner/12732065",
        "display": "PWDiabetesMe, Physician - Hospitalist"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "18883355",
              "display": "Covering Physician",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "PPRF",
              "display": "primary performer",
              "userSelected": false
            }
          ],
          "text": "Covering Physician"
        }
      ],
      "period": {
        "start": "2019-12-26T19:05:12.000Z",
        "end": "2020-01-17T06:01:53.000Z"
      },
      "individual": {
        "reference": "Practitioner/12724045",
        "display": "Graham, Joshua"
      }
    }
  ],
  "appointment": [
    {
      "reference": "Appointment/4818609"
    }
  ],
  "period": {
    "start": "2019-12-26T15:38:02.000Z",
    "end": "2020-01-07T06:00:00.000Z"
  },
  "reasonCode": [
    {
      "text": "Illness"
    },
    {
      "coding": [
        {
          "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/nomenclature",
          "code": "111611746",
          "display": "Illness",
          "userSelected": true
        }
      ],
      "text": "Illness"
    }
  ],
  "hospitalization": {
    "admitSource": {
      "coding": [
        {
          "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/2",
          "code": "4326381",
          "display": "Self (Non-HC Facility Source of Origin)",
          "userSelected": true
        }
      ],
      "text": "Self (Non-HC Facility Source of Origin)"
    }
  },
  "location": [
    {
      "location": {
        "reference": "Location/32545019",
        "display": "Model Hospital, MX Hospital, NU05, 102, A"
      },
      "status": "completed"
    }
  ],
  "serviceProvider": {
    "reference": "Organization/675844"
  }
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Patient Authorization Request

GET https://fhir-ehr.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97954225

Response

Status: 200 OK
{
  "resourceType": "Encounter",
  "id": "97954225",
  "meta": {
    "versionId": "0",
    "lastUpdated": "2020-08-04T12:37:34.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div xmlns="http://www.w3.org/1999/xhtml"><p><b>Encounter</b></p><p><b>Patient</b>: SMART, NANCY</p><p><b>Location</b>: Model Behavioral Health Hospital</p><p><b>Type</b>: Outpatient</p><p><b>Class</b>: Outpatient</p><p><b>Status</b>: In Progress</p></div>"
  },
  "identifier": [
    {
      "use": "usual",
      "type": {
        "coding": [
          {
            "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
            "code": "1077",
            "display": "FIN NBR",
            "userSelected": true
          },
          {
            "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
            "code": "AN",
            "display": "Account number",
            "userSelected": false
          }
        ],
        "text": "FIN NBR"
      },
      "system": "urn:oid:5.5.5.5.5.5.",
      "value": "16131",
      "period": {
        "start": "2020-08-04T12:37:34.000Z"
      }
    }
  ],
  "status": "in-progress",
  "class": {
    "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
    "code": "O",
    "display": "Outpatient",
    "userSelected": false
  },
  "type": [
    {
      "coding": [
        {
          "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
          "code": "309309",
          "display": "Outpatient",
          "userSelected": true
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O",
          "display": "Outpatient",
          "userSelected": false
        }
      ],
      "text": "Outpatient"
    }
  ],
  "subject": {
    "reference": "Patient/12724066",
    "display": "SMART, NANCY"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "242348525",
              "display": "Chart Review",
              "userSelected": true
            },
            {
              "system": "http://terminology.hl7.org/CodeSystem/v3-ParticipationType",
              "code": "PART",
              "display": "Participation",
              "userSelected": false
            }
          ],
          "text": "Chart Review"
        }
      ],
      "period": {
        "start": "2020-11-24T18:16:18.000Z"
      },
      "individual": {
        "reference": "Practitioner/12746397",
        "display": "Pwuptodate, RN"
      }
    }
  ],
  "location": [
    {
      "location": {
        "reference": "Location/31098367",
        "display": "Model Behavioral Health Hospital"
      },
      "status": "active"
    }
  ],
  "serviceProvider": {
    "reference": "Organization/1054423"
  }
}

Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.

Errors

The common errors and OperationOutcomes may be returned.

Create

Create an individual Encounter.

POST /Encounter

Authorization Types

Headers

Authorization: <OAuth2 Bearer Token>
Accept: application/fhir+json
Content-Type: application/fhir+json

Body Fields

Name Required Type
resourceType Yes string
  • Description
    • The type of the FHIR resource.
  • Example
    • {
        "resourceType": "Encounter"
      }
      
  • Notes
    • resourceType must be Encounter
identifier No List of Identifier
  • Description
    • Identifier(s) by which this encounter is known.
  • Example
    • {
        "identifier": [
          {
            "use": "usual",
            "type": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
                  "code": "1077",
                  "display": "FIN NBR"
                }
              ]
            },
            "system": "urn:oid:3.3.3.3.3.3",
            "value": "2009",
            "period": {
              "start": "2017-01-17T20:39:40.000Z"
            }
          }
        ]
      }
      
identifier.type Yes CodeableConcept
  • Description
    • The type for the identifier that can be used to determine which identifier to use for a specific purpose.
  • Example
    • {
        "type": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
              "code": "1077",
              "display": "FIN NBR"
            }
          ]
        }
      }
      
  • Example
    • {
        "type": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/319",
              "code": "1077"
            }
          ]
        }
      }
      
  • Notes
    • Required if identifier is given.
identifier.system Yes uri
  • Description
    • The namespace of the identifier.
  • Example
    • {
        "system": "urn:oid:3.3.3.3.3.3"
      }
      
  • Notes
    • Required if identifier is given.
identifier.value Yes string
  • Description
    • The unique value of the identifier
  • Example
    • {
        "value": "2009"
      }
      
  • Notes
    • Required if identifier is given.
status Yes code
  • Description
    • The status of the encounter.
  • Example
    • {
        "status": "in-progress"
      }
      
  • Notes
    • Currently do not support cancelled or entered-in-error.
class No code
  • Description
    • The classification of the encounter.
  • Example
    • {
        "class": "inpatient"
      }
      
  • Notes
    • Direct writing of class is not supported. This field will be inferred on a write.
type Yes List of CodeableConcept
  • Description
    • The specific type of encounter.
  • Example
    • {
        "type": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
                "code": "O"
              }
            ]
          }
        ]
      }
      
  • Example
    • {
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309310"
              }
            ]
          }
        ]
      }
      
priority No CodeableConcept
  • Description
    • Indicates the urgency of the encounter.
  • Example
    • {
        "priority": [
          {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ActPriority",
                "code": "O"
              }
            ]
          }
        ]
      }
      
  • Example
    • {
        "priority": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/3",
                "code": "309203"
              }
            ]
          }
        ]
      }
      
subject Yes Reference (Patient)
  • Description
    • The patient present at the encounter.
  • Example
    • {
        "subject": {
          "reference": "Patient/4342011"
        }
      }
      
participant No List of BackboneElement
  • Description
    • The list of people responsible for providing the service.
  • Example
    • {
        "participant": [
          {
            "type": [
              {
                "coding": [
                  {
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "code": "ATND"
                  }
                ]
              }
            ],
            "period": {
              "start": "2017-03-02T20:01:13.000Z"
            },
            "individual": {
              "reference": "Practitioner/1912007"
            }
          }
        ]
      }
      
participant.type Yes List of CodeableConcept
  • Description
    • Role of participant in encounter.
  • Example
    • {
        "type": [
          {
            "coding": [
              {
                "system": "http://hl7.org/fhir/v3/ParticipationType",
                "code": "ATND"
              }
            ]
          }
        ]
      }
      
  • Example
    • {
        "type": [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
                "code": "1126"
              }
            ]
          }
        ]
      }
      
  • Notes
    • Required if participant is given.
participant.period No Period
  • Description
    • The start and end times for the period the participant was involved in the encounter.
  • Example
    • {
        "period": {
          "start": "2017-03-02T01:13:00Z"
        }
      }
      
participant.individual Yes Reference (Practitioner, RelatedPerson)
  • Description
    • The personnel present at the encounter.
  • Example
    • {
        "reference": "Practitioner/1912007"
      }
      
  • Notes
    • Required if participant is given.
period No Period
  • Description
    • The start and end times of the encounter.
  • Example
    • {
        "period": {
          "start": "2017-03-02T01:13:00Z",
          "end": "2017-03-05T00:00:00Z"
        }
      }
      
  • Notes
    • A date with time must be provided.
reasonCode No List of CodeableConcept
  • Description
    • The reason that the encounter is taking place.
  • Example
    • {
        "reasonCode": [
          {
            "coding": [
              {
                "system": "http://snomed.info/sct",
                "code": "208388003",
                "display": "Fracture At Wrist And/Or Hand Level",
                "userSelected": true
              }
            ]
          }, {
            "text": "Neck pain"
          }
        ]
      }
      
  • Notes
    • ICD-10 and SNOMED codes along with text fields are supported for reasonCode.
hospitalization No BackboneElement
  • Description
    • Details about the admission to a healthcare service.
  • Example
    • {
        "hospitalization": {
          "admitSource": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/admit-source",
                "code": "born"
              }
            ]
          },
          "dischargeDisposition": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/discharge-disposition",
                "code": "other-hcf"
              }
            ]
          }
        }
      }
      
  • Notes
    • Only the admitSource and dischargeDisposition fields are supported on write.
hospitalization.admitSource No CodeableConcept
  • Description
    • From where patient was admitted.
  • Example
    • {
        "admitSource": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/admit-source",
              "code": "born"
            }
          ]
        }
      }
      
  • Example
    • {
        "admitSource": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/2",
              "code": "670834"
            }
          ]
        }
      }
      
hospitalization.dischargeDisposition No CodeableConcept
  • Description
    • Category or kind of location after discharge.
  • Example
    • {
        "dischargeDisposition": {
          "coding": [
            {
              "system": "http://terminology.hl7.org/CodeSystem/discharge-disposition",
              "code": "other-hcf"
            }
          ]
        }
      }
      
  • Example
    • {
        "dischargeDisposition": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/19",
              "code": "638660"
            }
          ]
        }
      }
      
serviceProvider Yes Reference (Organization)
  • Description
    • The organization (facility) responsible for this encounter.
  • Example
    • {
        "serviceProvider": {
          "reference": "Organization/619848"
        }
      }
      
meta.security No List of Coding
  • Description
    • Security labels applied to this resource.
  • Example
    • {
        "meta": [
          {
            "security": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v3-ObservationValue",
                "code": "UNCERTREL"
              }
            ]
          }
        ]
      }
      
  • Notes
    • Encounters created with meta.security set with code 'UNCERTREL' will be returned with an external encounter type.

Example

Request

POST https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter

Body

{
  "resourceType": "Encounter",
  "status": "in-progress",
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
          "code": "O"
        }
      ]
    }
  ],
  "priority": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/v3-ActPriority",
        "code": "EL"
      }
    ]
  },
  "subject": {
    "reference": "Patient/12724066"
  },
  "reasonCode": [
    {
      "text": "Neck Pain"
    }
  ],
  "hospitalization": {
    "admitSource": {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/admit-source",
          "code": "born"
        }
      ]
    },
    "dischargeDisposition": {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/discharge-disposition",
          "code": "other-hcf"
        }
      ]
    }
  },
  "serviceProvider": {
    "reference": "Organization/675844"
  },
  "period": {
    "start": "2020-03-02T01:13:00Z",
    "end": "2020-03-05T00:00:00Z"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/333",
              "code": "1119"
            }
          ]
        }
      ],
      "period": {
        "start": "2020-03-02T20:01:13.000Z"
      },
      "individual": {
        "reference": "Practitioner/4122622"
      }
    }
  ]
}

Response

Status: 201 Created
Cache-Control: no-cache
Content-Length: 0
Content-Type: application/fhir+json
Date: Wed, 27 Mar 2019 15:59:33 GMT
Etag: W/"0"
Last-Modified: Wed, 27 Mar 2019 15:59:30 GMT
Location: https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/1621910
Vary: Origin
X-Request-Id: 1638e30e497b93ff4383b2ff0eaeea68

The ETag response header indicates the current If-Match version to use on subsequent updates.

Errors

The common errors and OperationOutcomes may be returned.

Patch

Patch an existing encounter.

PATCH /Encounter/:id

Implementation Notes

Authorization Types

Headers

Authorization: <OAuth2 Bearer Token>
Accept: application/fhir+json
Content-Type: application/json-patch+json
If-Match: W/"<Current version of the Encounter resource>"

Patch Operations

Path Operation Value Type
/period/start replace dateTime
  • Description
    • The start time of the encounter.
  • Example
    • {
        "op": "replace",
        "path": "/period/start",
        "value":  "2015-09-01T00:00:00.000Z"
      }
      
  • Notes
      • When no value is provided the Encounter.period.start will be unset.
      • When Encounter.period.start value is provided, time component should be provided.
/period/end replace dateTime
  • Description
    • The end time of the encounter.
  • Example
    • {
        "op": "replace",
        "path": "/period/end",
        "value":  "2017-09-01T00:00:00.000Z"
      }
      
  • Notes
      • When no value is provided the Encounter.period.end will be unset.
      • When Encounter.period.end value is provided, time component should be provided.
/type replace List of CodeableConcept
  • Description
    • The specific type of encounter.
  • Example
    • {
        "op": "replace",
        "path": "/type",
        "value":  [
          {
            "coding": [
              {
                "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/71",
                "code": "309310"
              }
            ]
          }
        ]
      }
      
  • Notes
      • Encounter.type value should be a list.
      • When a list is provided, the first value would be used to patch Encounter.type.
/extension replace List of Extension
  • Description
    • The array of extensions for an encounter.
  • Example
    • {
        "op": "replace",
        "path": "/extension",
        "value":  [
          {
            "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/payment-collection-status",
            "valueCodeableConcept": {
              "coding": [
                {
                  "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4003489",
                  "code": "269411463",
                  "display": "1st Attempt - Left Message",
                  "userSelected": true
                }
              ],
              "text": "1st Attempt - Left Message"
            }
          },
          {
            'op': 'replace',
            'path': '/extension',
            'value': [
               {
                 'url': 'https://fhir-ehr.cerner.com/r4/StructureDefinition/estimated-financial-responsibility-amount',
                 'valueMoney': {
                   'value': 10.0,
                   'currency': 'USD'
                 }
               }
             ]
           }
        ]
      }
      
  • Notes

Example

Request

PATCH https://fhir-ehr-code.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Encounter/97939518

Body

[
  {
    "op": "replace",
    "path": "/period/start",
    "value": "2015-09-01T00:00:00.000Z"
  },
  {
    "op": "replace",
    "path": "/period/end",
    "value": "2017-09-01T00:00:00.000Z"
  },
  {
    "op": "replace",
    "path": "/type",
    "value": [
      {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/v2-0004",
            "code": "O",
            "display": "Outpatient",
            "userSelected": false
          }
        ]
      }
    ]
  },
  {
    "op": "replace",
    "path": "/extension",
    "value": [
      {
        "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/payment-collection-status",
        "valueCodeableConcept": {
          "coding": [
            {
              "system": "https://fhir.cerner.com/ec2458f2-1e24-41c8-b71b-0e701af7583d/codeSet/4003489",
              "code": "269411463",
              "display": "1st Attempt - Left Message",
              "userSelected": true
            }
          ],
          "text": "1st Attempt - Left Message"
        }
      }
    ]
  },
  {
    "op": "replace",
    "path": "/extension",
    "value": [
      {
        "url": "https://fhir-ehr.cerner.com/r4/StructureDefinition/estimated-financial-responsibility-amount",
        "valueMoney": {
          "value": 10.0,
          "currency": "USD"
        }
      }
    ]
  }
]

Response

Status: 200 OK
Cache-Control: no-cache
Content-Length: 0
Content-Type: text/html
Date: Tue, 26 Mar 2019 15:42:29 GMT
Etag: W/"10"
Last-Modified: Tue, 26 Mar 2019 15:42:27 GMT
Vary: Origin
X-Request-Id: 47306a14c8a2c3afd4ab85aa9594101d

The ETag response header indicates the current If-Match version to use on subsequent updates.

Errors

The common errors and OperationOutcomes may be returned.