This resource contains details and outcomes for a patient encounter, which can include one or more providers, locations, and services.
Encounters may encompass preadmission, outpatient visits, telehealth visits, inpatient stays, and discharges, depending on the organization and context for the encounter.
Encounters may contain references to procedures if:
- A procedure was completed during a patient visit.
- A follow-up procedure is scheduled as a result of the encounter.
You can review, retrieve, save, or cancel encounter details.
read
Review a specific Encounter resource with details about a patient visit.
- resourceTyperequired, string
Identifies the type of the resource
Value:Encounter
- statusrequired, string
Current status of the encounter.
Possible Values:planned
,arrived
,triaged
,in-progress
,onleave
,finished
,cancelled
,entered-in-error
,unknown
- classrequired, object
Concepts representing classification of patient encounter such as ambulatory (outpatient), inpatient, emergency, home health or others due to local variations.
- extensionArray of OriginalText or Other
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
- urlrequired, string
Source of the definition for the extension code - a logical name or a URL.
Value:http://hl7.org/fhir/StructureDefinition/originalText
- valueStringrequired, string
The original text
A human language representation of the concept (resource/element) as seen/selected/uttered by the user who entered the data and/or which represents the full intended meaning of the user.
See http://hl7.org/fhir/StructureDefinition/originalText for more information
- systemstring
The identification of the code system that defines the meaning of the symbol in the code.
- codestring
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
- typerequired, Array of object
Specific type of encounter (e.g. e-mail consultation, surgical day-care, skilled nursing, rehabilitation).
- codingArray of object
A reference to a code defined by a terminology system.
- systemstring
The identification of the code system that defines the meaning of the symbol in the code.
- codestring
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
- textstring
A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
- subjectrequired, object
The patient or group present at the encounter.
Must be a resource of type
Patient
.- referencestring
A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with
#
and refers to a contained resource.
- idstring
The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.
- extensionArray of Boolean, String, CodeableConcept, Coding
May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
- urlrequired, string
Source of the definition for the extension code - a logical name or a URL.
- valueBooleanboolean
A single value for the extension.
- identifierArray of object
Identifier(s) by which this encounter is known.
- systemrequired, string
Establishes the namespace for the value - that is, a URL that describes a set values that are unique.
- valuerequired, string
The portion of the identifier typically relevant to the user and which is unique within the context of the system.
- extensionArray of Boolean, String, CodeableConcept, Coding
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
- urlrequired, string
Source of the definition for the extension code - a logical name or a URL.
- valueBooleanboolean
A single value for the extension.
- usestring
The purpose of this identifier.
Possible Values:usual
,official
,temp
,secondary
,old (If known)
- participantArray of object
The list of people responsible for providing the service.
- typeArray of object
Role of the participant in encounter eg,
ATND
=AttendingProvider,CON
=ConsultingProvider,REF
=ReferringProvider,PART
=VisitProvider- codingArray of object
A reference to a code defined by a terminology system.
- systemstring
The identification of the code system that defines the meaning of the symbol in the code.
- codestring
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
- textstring
A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
- periodobject
The period of time that the specified participant participated in the encounter. These can overlap or be sub-sets of the overall encounter's period.
- startstring
The start of the period. The boundary is inclusive.
- endstring
The end of the period. If the end of the period is missing, it means no end was known or planned at the time the instance was created. The start may be in the past, and the end date in the future, which means that period is expected/planned to end at that time.
- individualobject
Persons involved in the encounter other than the patient.
Must reference one of the following types of resources:
Practitioner
PractitionerRole
RelatedPerson
- referencestring
A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with
#
and refers to a contained resource.
- periodobject
The start and end time of the encounter.
- startstring
The start of the period. The boundary is inclusive.
- endstring
The end of the period. If the end of the period is missing, it means no end was known or planned at the time the instance was created. The start may be in the past, and the end date in the future, which means that period is expected/planned to end at that time.
- lengthobject
Quantity of time the encounter lasted. This excludes the time during leaves of absence.
- valuenumber
The value of the measured amount. The value includes an implicit precision in the presentation of the value.
- systemstring
The identification of the system that provides the coded form of the unit.
- codestring
A computer processable form of the unit in some unit representation system.
- reasonCodeArray of object
Reason the encounter takes place, expressed as a code. For admissions, this can be used for a coded admission diagnosis.
- extensionArray of OriginalText or Other
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
- urlrequired, string
Source of the definition for the extension code - a logical name or a URL.
Value:http://hl7.org/fhir/StructureDefinition/originalText
- valueStringrequired, string
The original text
A human language representation of the concept (resource/element) as seen/selected/uttered by the user who entered the data and/or which represents the full intended meaning of the user.
See http://hl7.org/fhir/StructureDefinition/originalText for more information
- textstring
A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
- diagnosisArray of object
The list of diagnosis relevant to this encounter.
- conditionrequired, object
Reason the encounter takes place, as specified using information from another resource. For admissions, this is the admission diagnosis. The indication will typically be a Condition (with other resources referenced in the evidence.detail), or a Procedure.
Must be a resource of type
Condition
.- referencestring
A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with
#
and refers to a contained resource.
- accountArray of object
The set of accounts that may be used for billing for this Encounter.
Must be a resource of type
Account
.- referencestring
A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with
#
and refers to a contained resource.
- hospitalizationobject
Details about the admission to a healthcare service.
- destinationobject
Location/organization to which the patient is discharged.
Must reference one of the following types of resources:
Location
Organization
- referencestring
A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with
#
and refers to a contained resource.
- dischargeDispositionobject
Category or kind of location after discharge.
- codingArray of object
A reference to a code defined by a terminology system.
- systemstring
The identification of the code system that defines the meaning of the symbol in the code.
- codestring
A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination).
- textstring
A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user.
- locationArray of object
List of locations where the patient has been during this encounter.
- locationrequired, object
The location where the encounter takes place.
Must be a resource of type
Location
.- referencestring
A reference to another resource. This is typically either a relative reference which includes the resource type and ID, or an internal reference which starts with
#
and refers to a contained resource.
- statusstring
The status of the participants' presence at the specified location during the period specified. If the participant is no longer at the location, then the period will have an end date/time.
Possible Values:planned
,active
,reserved
,completed
A profile on the encounter resource that conforms to Redox requirements.