> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# EpisodeOfCare

> An association between a patient and an organization / healthcare provider(s) during which time encounters may occur. The managing organization assumes a level of responsibility for the patient during this time.

## Properties

| Name                 | Required | Type                                                                                                                                    | Description                                                                                          |
| -------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| identifier           | No       | [Identifier](/medical-api/fhir/data-types/identifier)\[]                                                                                | Business Identifier(s) relevant for this EpisodeOfCare                                               |
| status               | Yes      | code                                                                                                                                    | planned / waitlist / active / onhold / finished / cancelled / entered-in-error                       |
| statusHistory        | No       | EpisodeOfCareStatusHistory                                                                                                              | Past list of status codes (the current status may be included to cover the start date of the status) |
| - id                 | No       | string                                                                                                                                  | Unique id for inter-element referencing                                                              |
| - extension          | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                  | Additional content defined by implementations                                                        |
| - modifierExtension  | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                  | Extensions that cannot be ignored even if unrecognized                                               |
| - status             | Yes      | code                                                                                                                                    | planned / waitlist / active / onhold / finished / cancelled / entered-in-error                       |
| - period             | Yes      | [Period](/medical-api/fhir/data-types/period)                                                                                           | Duration the EpisodeOfCare was in the specified status                                               |
| type                 | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)\[]                                                                      | Type/class - e.g. specialist referral, disease management                                            |
| diagnosis            | No       | EpisodeOfCareDiagnosis                                                                                                                  | The list of diagnosis relevant to this episode of care                                               |
| - id                 | No       | string                                                                                                                                  | Unique id for inter-element referencing                                                              |
| - extension          | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                  | Additional content defined by implementations                                                        |
| - modifierExtension  | No       | [Extension](/medical-api/fhir/data-types/extension)\[]                                                                                  | Extensions that cannot be ignored even if unrecognized                                               |
| - condition          | Yes      | Reference\<[Condition](/medical-api/fhir/resources/condition)>                                                                          | Conditions/problems/diagnoses this episode of care is for                                            |
| - role               | No       | [CodeableConcept](/medical-api/fhir/data-types/codeableconcept)                                                                         | Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …)       |
| - rank               | No       | positiveInt                                                                                                                             | Ranking of the diagnosis (for each role type)                                                        |
| patient              | Yes      | Reference\<[Patient](/medical-api/fhir/resources/patient)>                                                                              | The patient who is the focus of this episode of care                                                 |
| managingOrganization | No       | Reference\<[Organization](/medical-api/fhir/resources/organization)>                                                                    | Organization that assumes care                                                                       |
| period               | No       | [Period](/medical-api/fhir/data-types/period)                                                                                           | Interval during responsibility is assumed                                                            |
| referralRequest      | No       | Reference\<[ServiceRequest](/medical-api/fhir/resources/servicerequest)>\[]                                                             | Originating Referral Request(s)                                                                      |
| careManager          | No       | Reference\<[Practitioner](/medical-api/fhir/resources/practitioner) / [PractitionerRole](/medical-api/fhir/resources/practitionerrole)> | Care manager/care coordinator for the patient                                                        |
| team                 | No       | Reference\<[CareTeam](/medical-api/fhir/resources/careteam)>\[]                                                                         | Other practitioners facilitating this episode of care                                                |
| account              | No       | Reference\<[Account](/medical-api/fhir/resources/account)>\[]                                                                           | The set of accounts that may be used for billing for this EpisodeOfCare                              |

## Search Parameters

| Name              | Type      | Description                                                                                          | Expression                         |
| ----------------- | --------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------- |
| date              | date      | The provided date search value falls within the episode of care's period                             | EpisodeOfCare.period               |
| identifier        | token     | Business Identifier(s) relevant for this EpisodeOfCare                                               | EpisodeOfCare.identifier           |
| patient           | reference | The patient who is the focus of this episode of care                                                 | EpisodeOfCare.patient              |
| type              | token     | Type/class - e.g. specialist referral, disease management                                            | EpisodeOfCare.type                 |
| care-manager      | reference | Care manager/care coordinator for the patient                                                        | EpisodeOfCare.careManager          |
| condition         | reference | Conditions/problems/diagnoses this episode of care is for                                            | EpisodeOfCare.diagnosis.condition  |
| incoming-referral | reference | Incoming Referral Request                                                                            | EpisodeOfCare.referralRequest      |
| organization      | reference | The organization that has assumed the specific responsibilities of this EpisodeOfCare                | EpisodeOfCare.managingOrganization |
| status            | token     | The current status of the Episode of Care as provided (does not check the status history collection) | EpisodeOfCare.status               |

## Inherited Properties

| Name              | Required | Type                                                   | Description                                            |
| ----------------- | -------- | ------------------------------------------------------ | ------------------------------------------------------ |
| id                | No       | string                                                 | Logical id of this artifact                            |
| meta              | No       | [Meta](/medical-api/fhir/data-types/meta)              | Metadata about the resource                            |
| implicitRules     | No       | uri                                                    | A set of rules under which this content was created    |
| language          | No       | code                                                   | Language of the resource content                       |
| text              | No       | [Narrative](/medical-api/fhir/data-types/narrative)    | Text summary of the resource, for human interpretation |
| contained         | No       | Resource\[]                                            | Contained, inline Resources                            |
| extension         | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Additional content defined by implementations          |
| modifierExtension | No       | [Extension](/medical-api/fhir/data-types/extension)\[] | Extensions that cannot be ignored                      |

To view the FHIR specification for this resource, see [EpisodeOfCare](https://www.hl7.org/fhir/StructureDefinition/EpisodeOfCare).