> ## 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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.