This page is part of the FHIR Specification (v3.5.0: R4 Ballot #2). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions
. Page versions: R5 R4B R4
Patient Administration Work Group | Maturity Level: 0 | Trial Use | Compartments: Not linked to any defined compartments |
Detailed Descriptions for the elements in the InsurancePlan resource.
| InsurancePlan | |||||||||
| Element Id | InsurancePlan | ||||||||
| Definition | Details of a Health Insurance product/plan provided by an organization. | ||||||||
| Control | 1..1 | ||||||||
| Type | DomainResource | ||||||||
| Invariants |
| ||||||||
| InsurancePlan.identifier | |||||||||
| Element Id | InsurancePlan.identifier | ||||||||
| Definition | Business identifiers assigned to this health insurance product which remain constant as the resource is updated and propagates from server to server. | ||||||||
| Note | This is a business identifer, not a resource identifier (see discussion) | ||||||||
| Control | 0..* | ||||||||
| Type | Identifier | ||||||||
| Summary | true | ||||||||
| Invariants |
| ||||||||
| InsurancePlan.status | |||||||||
| Element Id | InsurancePlan.status | ||||||||
| Definition | The current state of the health insurance product. | ||||||||
| Control | 0..1 | ||||||||
| Terminology Binding | PublicationStatus (Required) | ||||||||
| Type | code | ||||||||
| Is Modifier | true (Reason: This element is labeled as a modifier because it is a status element that contains codes which means that the resource should not be treated as valid) | ||||||||
| Meaning if Missing | Default interpretation is active. | ||||||||
| Requirements | Need a flag to indicate a record is no longer to be used and should generally be hidden for the user in the UI. | ||||||||
| Summary | true | ||||||||
| InsurancePlan.type | |||||||||
| Element Id | InsurancePlan.type | ||||||||
| Definition | The kind of health insurance product. | ||||||||
| Control | 0..* | ||||||||
| Terminology Binding | Insurance plan type (Example) | ||||||||
| Type | CodeableConcept | ||||||||
| Summary | true | ||||||||
| InsurancePlan.name | |||||||||
| Element Id | InsurancePlan.name | ||||||||
| Definition | Official name of the health insurance product as designated by the owner. | ||||||||
| Control | 0..1 | ||||||||
| Type | string | ||||||||
| Summary | true | ||||||||
| Comments | If the name of the product/plan changes, consider putting the old name in the alias column so that it can still be located through searches. | ||||||||
| Invariants |
| ||||||||
| InsurancePlan.alias | |||||||||
| Element Id | InsurancePlan.alias | ||||||||
| Definition | A list of alternate names that the product is known as, or was known as in the past. | ||||||||
| Control | 0..* | ||||||||
| Type | string | ||||||||
| Requirements | Over time products/plans go through many changes and can be known by different names. For searching knowing previous names that the product/plan was known by can be very useful. | ||||||||
| Comments | There are no dates associated with the alias/historic names, as this is not intended to track when names were used, but to assist in searching so that older names can still result in identifying the product/plan. | ||||||||
| InsurancePlan.period | |||||||||
| Element Id | InsurancePlan.period | ||||||||
| Definition | The period of time that the health insurance product is available. | ||||||||
| Control | 0..1 | ||||||||
| Type | Period | ||||||||
| InsurancePlan.ownedBy | |||||||||
| Element Id | InsurancePlan.ownedBy | ||||||||
| Definition | The entity that is providing the health insurance product and underwriting the risk. This is typically an insurance carriers, other third-party payers, or health plan sponsors comonly referred to as 'payers'. | ||||||||
| Control | 0..1 | ||||||||
| Type | Reference(Organization) | ||||||||
| Alternate Names | Payer | ||||||||
| Summary | true | ||||||||
| InsurancePlan.administeredBy | |||||||||
| Element Id | InsurancePlan.administeredBy | ||||||||
| Definition | An organization which administer other services such as underwriting, customer service and/or claims processing on behalf of the health insurance product owner. | ||||||||
| Control | 0..1 | ||||||||
| Type | Reference(Organization) | ||||||||
| Summary | true | ||||||||
| InsurancePlan.coverageArea | |||||||||
| Element Id | InsurancePlan.coverageArea | ||||||||
| Definition | The geographic region in which a health insurance product's benefits apply. | ||||||||
| Control | 0..* | ||||||||
| Type | Reference(Location) | ||||||||
| Summary | true | ||||||||
| InsurancePlan.contact | |||||||||
| Element Id | InsurancePlan.contact | ||||||||
| Definition | The contact for the health insurance product for a certain purpose. | ||||||||
| Control | 0..* | ||||||||
| Requirements | Need to keep track of assigned contact points within bigger organization. | ||||||||
| Comments | Where multiple contacts for the same purpose are provided there is a standard extension that can be used to determine which one is the preferred contact to use. | ||||||||
| InsurancePlan.contact.purpose | |||||||||
| Element Id | InsurancePlan.contact.purpose | ||||||||
| Definition | Indicates a purpose for which the contact can be reached. | ||||||||
| Control | 0..1 | ||||||||
| Terminology Binding | Contact entity type (Extensible) | ||||||||
| Type | CodeableConcept | ||||||||
| Requirements | Need to distinguish between multiple contact persons. | ||||||||
| InsurancePlan.contact.name | |||||||||
| Element Id | InsurancePlan.contact.name | ||||||||
| Definition | A name associated with the contact. | ||||||||
| Control | 0..1 | ||||||||
| Type | HumanName | ||||||||
| Requirements | Need to be able to track the person by name. | ||||||||
| InsurancePlan.contact.telecom | |||||||||
| Element Id | InsurancePlan.contact.telecom | ||||||||
| Definition | A contact detail (e.g. a telephone number or an email address) by which the party may be contacted. | ||||||||
| Control | 0..* | ||||||||
| Type | ContactPoint | ||||||||
| Requirements | People have (primary) ways to contact them in some way such as phone, email. | ||||||||
| InsurancePlan.contact.address | |||||||||
| Element Id | InsurancePlan.contact.address | ||||||||
| Definition | Visiting or postal addresses for the contact. | ||||||||
| Control | 0..1 | ||||||||
| Type | Address | ||||||||
| Requirements | May need to keep track of a contact party's address for contacting, billing or reporting requirements. | ||||||||
| InsurancePlan.endpoint | |||||||||
| Element Id | InsurancePlan.endpoint | ||||||||
| Definition | The technical endpoints providing access to services operated for the health insurance product. | ||||||||
| Control | 0..* | ||||||||
| Type | Reference(Endpoint) | ||||||||
| Requirements | Organizations have multiple systems that provide various services and need to be able to define the technical connection details for how to connect to them, and for what purpose. | ||||||||
| InsurancePlan.network | |||||||||
| Element Id | InsurancePlan.network | ||||||||
| Definition | Reference to the network included in the health insurance product. | ||||||||
| Control | 0..* | ||||||||
| Type | Reference(Organization) | ||||||||
| Comments | Networks are represented as a hierarchy of organization resources. | ||||||||
| InsurancePlan.coverage | |||||||||
| Element Id | InsurancePlan.coverage | ||||||||
| Definition | Details about the coverage offered by the insurance product. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.coverage.type | |||||||||
| Element Id | InsurancePlan.coverage.type | ||||||||
| Definition | Type of coverage (Medical; Dental; Mental Health; Substance Abuse; Vision; Drug; Short Term; Long Term Care; Hospice; Home Health). | ||||||||
| Control | 1..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.coverage.network | |||||||||
| Element Id | InsurancePlan.coverage.network | ||||||||
| Definition | Reference to the network that providing the type of coverage. | ||||||||
| Control | 0..* | ||||||||
| Type | Reference(Organization) | ||||||||
| Comments | Networks are represented as a hierarchy of organization resources. | ||||||||
| InsurancePlan.coverage.benefit | |||||||||
| Element Id | InsurancePlan.coverage.benefit | ||||||||
| Definition | Specific benefits under this type of coverage. | ||||||||
| Control | 1..* | ||||||||
| InsurancePlan.coverage.benefit.type | |||||||||
| Element Id | InsurancePlan.coverage.benefit.type | ||||||||
| Definition | Type of benefit (primary care; speciality care; inpatient; outpatient). | ||||||||
| Control | 1..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.coverage.benefit.requirement | |||||||||
| Element Id | InsurancePlan.coverage.benefit.requirement | ||||||||
| Definition | The referral requirements to have access/coverage for this benefit. | ||||||||
| Control | 0..1 | ||||||||
| Type | string | ||||||||
| InsurancePlan.coverage.benefit.limit | |||||||||
| Element Id | InsurancePlan.coverage.benefit.limit | ||||||||
| Definition | The specific limits on the benefit. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.coverage.benefit.limit.value | |||||||||
| Element Id | InsurancePlan.coverage.benefit.limit.value | ||||||||
| Definition | The maximum amount of a service item a plan will pay for a covered benefit. For examples. wellness visits, or eyeglasses. | ||||||||
| Control | 0..1 | ||||||||
| Type | Quantity | ||||||||
| Comments | May also be called “eligible expense,” “payment allowance,” or “negotiated rate.”. | ||||||||
| InsurancePlan.coverage.benefit.limit.code | |||||||||
| Element Id | InsurancePlan.coverage.benefit.limit.code | ||||||||
| Definition | The specific limit on the benefit. | ||||||||
| Control | 0..1 | ||||||||
| Type | CodeableConcept | ||||||||
| Comments | Use | ||||||||
| InsurancePlan.plan | |||||||||
| Element Id | InsurancePlan.plan | ||||||||
| Definition | Details about an insurance plan. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.plan.identifier | |||||||||
| Element Id | InsurancePlan.plan.identifier | ||||||||
| Definition | Business identifiers assigned to this health insurance plan which remain constant as the resource is updated and propagates from server to server. | ||||||||
| Note | This is a business identifer, not a resource identifier (see discussion) | ||||||||
| Control | 0..* | ||||||||
| Type | Identifier | ||||||||
| Summary | true | ||||||||
| InsurancePlan.plan.type | |||||||||
| Element Id | InsurancePlan.plan.type | ||||||||
| Definition | Type of plan. For example, "Platinum" or "High Deductable". | ||||||||
| Control | 0..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.coverageArea | |||||||||
| Element Id | InsurancePlan.plan.coverageArea | ||||||||
| Definition | The geographic region in which a health insurance plan's benefits apply. | ||||||||
| Control | 0..* | ||||||||
| Type | Reference(Location) | ||||||||
| Summary | true | ||||||||
| InsurancePlan.plan.network | |||||||||
| Element Id | InsurancePlan.plan.network | ||||||||
| Definition | Reference to the network that providing the type of coverage. | ||||||||
| Control | 0..* | ||||||||
| Type | Reference(Organization) | ||||||||
| Comments | Networks are represented as a hierarchy of organization resources. | ||||||||
| InsurancePlan.plan.generalCost | |||||||||
| Element Id | InsurancePlan.plan.generalCost | ||||||||
| Definition | Overall costs associated with the plan. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.plan.generalCost.type | |||||||||
| Element Id | InsurancePlan.plan.generalCost.type | ||||||||
| Definition | Type of cost. | ||||||||
| Control | 0..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.generalCost.groupSize | |||||||||
| Element Id | InsurancePlan.plan.generalCost.groupSize | ||||||||
| Definition | Number of participants enrolled in the plan. | ||||||||
| Control | 0..1 | ||||||||
| Type | positiveInt | ||||||||
| InsurancePlan.plan.generalCost.cost | |||||||||
| Element Id | InsurancePlan.plan.generalCost.cost | ||||||||
| Definition | Value of the cost. | ||||||||
| Control | 0..1 | ||||||||
| Type | Money | ||||||||
| InsurancePlan.plan.generalCost.comment | |||||||||
| Element Id | InsurancePlan.plan.generalCost.comment | ||||||||
| Definition | Additional information about the general costs associated with this plan. | ||||||||
| Control | 0..1 | ||||||||
| Type | string | ||||||||
| InsurancePlan.plan.specificCost | |||||||||
| Element Id | InsurancePlan.plan.specificCost | ||||||||
| Definition | Costs associated with the coverage provided by the product. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.plan.specificCost.category | |||||||||
| Element Id | InsurancePlan.plan.specificCost.category | ||||||||
| Definition | General category of benefit (Medical; Dental; Vision; Drug; Mental Health; Substance Abuse; Hospice, Home Health). | ||||||||
| Control | 1..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.specificCost.benefit | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit | ||||||||
| Definition | List of the specific benefits under this category of benefit. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.plan.specificCost.benefit.type | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit.type | ||||||||
| Definition | Type of specific benefit (preventative; primary care office visit; speciality office visit; hospitalization; emergency room; urgent care). | ||||||||
| Control | 1..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.specificCost.benefit.cost | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit.cost | ||||||||
| Definition | List of the costs associated with a specific benefit. | ||||||||
| Control | 0..* | ||||||||
| InsurancePlan.plan.specificCost.benefit.cost.type | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit.cost.type | ||||||||
| Definition | Type of cost (copay; individual cap; family cap; coinsurance; deductible). | ||||||||
| Control | 1..1 | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.specificCost.benefit.cost.applicability | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit.cost.applicability | ||||||||
| Definition | Whether the cost applies to in-network or out-of-network providers (in-network; out-of-network; other). | ||||||||
| Control | 0..1 | ||||||||
| Terminology Binding | Benefit cost applicability (Required) | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.specificCost.benefit.cost.qualifiers | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit.cost.qualifiers | ||||||||
| Definition | Additional information about the cost, such as information about funding sources (e.g. HSA, HRA, FSA, RRA). | ||||||||
| Control | 0..* | ||||||||
| Type | CodeableConcept | ||||||||
| InsurancePlan.plan.specificCost.benefit.cost.value | |||||||||
| Element Id | InsurancePlan.plan.specificCost.benefit.cost.value | ||||||||
| Definition | The actual cost value. (some of the costs may be represented as percentages rather than currency, e.g. 10% coinsurance). | ||||||||
| Control | 0..1 | ||||||||
| Type | Quantity | ||||||||