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:

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://hl7.org/fhir/v2/0203

Encounter.type
  • Description
    • The type of encounter.
  • Note
    • Currently not bound to any terminology.
Encounter.priority
  • Description
    • Indicates the urgency of the encounter.
  • Details: Encounter Priority
    System: http://hl7.org/fhir/encounter-priority

Encounter.participant.type
Encounter.reason
  • Description
    • The type of encounter.
  • Note
    • Currently not bound to any terminology. The value would always be returned as a free-text value.
Encounter.hospitalization.admitSource
  • Description
    • From where patient was admitted.
  • Details: AdmitSource
    System: http://hl7.org/fhir/admit-source

Encounter.hospitalization.dietPreference
  • Description
    • Medical, cultural or ethical food preferences to help with catering requirements.
  • Details: Diet
    System: http://hl7.org/fhir/diet

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

Encounter.hospitalization.dischargeDisposition
  • Description
    • Discharge Disposition.
  • Details: DischargeDisposition
    System: http://hl7.org/fhir/discharge-disposition

Contained Location Bindings

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

Search for Encounters that meet supplied query parameters:

GET /Encounter?:parameters

Implementation Notes

Authorization Types

Parameters

Name Required? Type Description
_id This or patient token The logical resource id associated with the Encounter. Example: 7891
patient This or _id reference The patient present at the encounter. Example: 12345

Headers

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

Example

Request

GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Encounter?patient=4342010

Response

Status: 200 OK
{
  "entry": [
    {
      "fullUrl": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Encounter/4027918",
      "resource": {
        "class": "inpatient",
        "id": "4027918",
        "identifier": [
          {
            "period": {
              "start": "2016-06-22T21:06:58.000Z"
            },
            "system": "urn:oid:3.3.3.3.3.3",
            "type": {
              "text": "FIN NBR"
            },
            "use": "usual",
            "value": "20003412"
          }
        ],
        "location": [
          {
            "location": {
              "display": "Baseline East Medical Center, BE Hospital, 1N, 0152, A",
              "reference": "Location/35646785"
            },
            "status": "completed"
          }
        ],
        "meta": {
          "lastUpdated": "2016-06-27T15:01:18.000Z",
          "versionId": "1"
        },
        "participant": [
          {
            "individual": {
              "display": "Who, Doctor",
              "reference": "Practitioner/1"
            },
            "period": {
              "start": "2016-11-09T18:07:16.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "ADM",
                    "display": "admitter",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Admitting Physician"
              }
            ]
          },
          {
            "individual": {
              "display": "Song, River",
              "reference": "Practitioner/2048007"
            },
            "period": {
              "start": "2016-11-09T15:44:00.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "ADM",
                    "display": "admitter",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Admitting Physician"
              }
            ]
          },
          {
            "individual": {
              "display": "Strange, Doctor",
              "reference": "Practitioner/1912007"
            },
            "period": {
              "start": "2016-06-22T21:06:58.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "ADM",
                    "display": "admitter",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Admitting Physician"
              }
            ]
          },
          {
            "individual": {
              "display": "Strange, Doctor",
              "reference": "Practitioner/1912007"
            },
            "period": {
              "start": "2016-06-22T21:06:58.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "ATND",
                    "display": "attender",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Attending Physician"
              }
            ]
          },
          {
            "individual": {
              "display": "Strange, Doctor",
              "reference": "Practitioner/1912007"
            },
            "period": {
              "start": "2016-06-27T15:03:36.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "PPRF",
                    "display": "primary performer",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Ordering Physician"
              }
            ]
          },
          {
            "individual": {
              "display": "Frankenstein, Doctor",
              "reference": "Practitioner/1590015"
            },
            "period": {
              "end": "2016-06-23T18:34:38.000Z",
              "start": "2016-06-23T18:34:38.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "PART",
                    "display": "Participation",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Other"
              }
            ]
          },
          {
            "individual": {
              "display": "Strange, Doctor",
              "reference": "Practitioner/1912007"
            },
            "period": {
              "start": "2016-06-22T21:06:58.000Z"
            },
            "type": [
              {
                "coding": [
                  {
                    "code": "REF",
                    "display": "referrer",
                    "system": "http://hl7.org/fhir/v3/ParticipationType",
                    "userSelected": false
                  }
                ],
                "text": "Referring Physician"
              }
            ]
          }
        ],
        "patient": {
          "display": "Smart, Joe",
          "reference": "Patient/4342010"
        },
        "period": {
          "start": "2016-06-22T21:05:00.000Z"
        },
        "resourceType": "Encounter",
        "serviceProvider": {
          "reference": "Organization/619848"
        },
        "status": "finished",
        "text": {
          "div": "<div><p><b>Encounter</b></p><p><b>Location</b>: Baseline East Medical Center, BE Hospital, 1N, 0152, A</p><p><b>Type</b>: Inpatient</p><p><b>Status</b>: Discharged</p><p><b>Period Start Date</b>: Wed Jun 22 21:05:00 2016 (UTC)</p><p><b>Attending Physician</b>: Strange, Doctor</p></div>",
          "status": "generated"
        },
        "type": [
          {
            "text": "Inpatient"
          }
        ]
      }
    }
  ],
  "id": "9ae23e0d-8335-4dec-ba53-6dabe322dd43",
  "link": [
    {
      "relation": "self",
      "url": "https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Encounter?patient=4342010"
    }
  ],
  "resourceType": "Bundle",
  "total": 1,
  "type": "searchset"
}

Errors

The common errors may be returned.

Retrieve by id

List an individual Encounter by its id:

GET /Encounter/:id

Implementation Notes

Authorization Types

Headers

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

Example

Request

GET https://fhir-open.sandboxcerner.com/dstu2/0b8a0111-e8e6-4c26-a91c-5069cbc6b1ca/Encounter/4027918

Response

Status: 200 OK
{
  "resourceType": "Encounter",
  "id": "4027918",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2016-06-27T15:01:18.000Z"
  },
  "text": {
    "status": "generated",
    "div": "<div><p><b>Encounter</b></p><p><b>Location</b>: Baseline East Medical Center, BE Hospital, 1N, 0152, A</p><p><b>Type</b>: Inpatient</p><p><b>Status</b>: Discharged</p><p><b>Period Start Date</b>: Wed Jun 22 21:05:00 2016 (UTC)</p><p><b>Attending Physician</b>: Who, Doctor</p></div>"
  },
  "identifier": [
    {
      "use": "usual",
      "type": {
        "text": "FIN NBR"
      },
      "system": "urn:oid:3.3.3.3.3.3",
      "value": "20003412",
      "period": {
        "start": "2016-06-22T21:06:58.000Z"
      }
    }
  ],
  "status": "finished",
  "class": "inpatient",
  "type": [
    {
      "text": "Inpatient"
    }
  ],
  "patient": {
    "reference": "Patient/4342010",
    "display": "Smart, Joe"
  },
  "participant": [
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "ADM",
              "display": "admitter",
              "userSelected": false
            }
          ],
          "text": "Admitting Physician"
        }
      ],
      "period": {
        "start": "2016-11-09T18:07:16.000Z"
      },
      "individual": {
        "reference": "Practitioner/1",
        "display": "Who, Doctor"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "ADM",
              "display": "admitter",
              "userSelected": false
            }
          ],
          "text": "Admitting Physician"
        }
      ],
      "period": {
        "start": "2016-11-09T15:44:00.000Z"
      },
      "individual": {
        "reference": "Practitioner/2048007",
        "display": "Song, River"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "ADM",
              "display": "admitter",
              "userSelected": false
            }
          ],
          "text": "Admitting Physician"
        }
      ],
      "period": {
        "start": "2016-06-22T21:06:58.000Z"
      },
      "individual": {
        "reference": "Practitioner/1912007",
        "display": "Who, Doctor"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "ATND",
              "display": "attender",
              "userSelected": false
            }
          ],
          "text": "Attending Physician"
        }
      ],
      "period": {
        "start": "2016-06-22T21:06:58.000Z"
      },
      "individual": {
        "reference": "Practitioner/1912007",
        "display": "Song, River"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "PPRF",
              "display": "primary performer",
              "userSelected": false
            }
          ],
          "text": "Ordering Physician"
        }
      ],
      "period": {
        "start": "2016-06-27T15:03:36.000Z"
      },
      "individual": {
        "reference": "Practitioner/1912007",
        "display": "Song, River"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "PART",
              "display": "Participation",
              "userSelected": false
            }
          ],
          "text": "Other"
        }
      ],
      "period": {
        "start": "2016-06-23T18:34:38.000Z",
        "end": "2016-06-23T18:34:38.000Z"
      },
      "individual": {
        "reference": "Practitioner/1590015",
        "display": "Strange, Doctor"
      }
    },
    {
      "type": [
        {
          "coding": [
            {
              "system": "http://hl7.org/fhir/v3/ParticipationType",
              "code": "REF",
              "display": "referrer",
              "userSelected": false
            }
          ],
          "text": "Referring Physician"
        }
      ],
      "period": {
        "start": "2016-06-22T21:06:58.000Z"
      },
      "individual": {
        "reference": "Practitioner/1912007",
        "display": "Song, River"
      }
    }
  ],
  "period": {
    "start": "2016-06-22T21:05:00.000Z"
  },
  "location": [
    {
      "location": {
        "reference": "Location/35646785",
        "display": "Baseline East Medical Center, BE Hospital, 1N, 0152, A"
      },
      "status": "completed"
    }
  ],
  "serviceProvider": {
    "reference": "Organization/619848"
  }
}

Errors

The common errors may be returned.